Compare commits
2 Commits
977e165b28
...
493ac414e4
Author | SHA1 | Date |
---|---|---|
fox | 493ac414e4 | |
fox | fa0ad184c9 |
28
SETUP.md
28
SETUP.md
|
@ -17,25 +17,20 @@ Mastodon development requires the following:
|
||||||
|
|
||||||
### macOS
|
### macOS
|
||||||
|
|
||||||
First, make sure you have Homebrew installed. Follow the instructions at
|
First, make sure you have Homebrew installed. Follow the instructions at [brew.sh](https://brew.sh).
|
||||||
[brew.sh](https://brew.sh).
|
|
||||||
|
|
||||||
Run the following to install all necessary packages:
|
Run the following to install all necessary packages:
|
||||||
```
|
```
|
||||||
brew install ruby@3.0 foreman node yarn postgresql redis
|
brew install ruby@3.0 foreman node yarn postgresql redis
|
||||||
```
|
```
|
||||||
|
|
||||||
Ruby 3.0 is **keg-only** by default. Follow the instructions in the **Caveat**
|
Ruby 3.0 is **keg-only** by default. Follow the instructions in the **Caveat** to add it to your path.
|
||||||
to add it to your path.
|
|
||||||
|
|
||||||
### Linux
|
### Linux
|
||||||
|
|
||||||
We will assume that you know how to locate the correct packages for your distro.
|
We will assume that you know how to locate the correct packages for your distro. That said, some distros package `bundler` and `irb` separately. Make sure that you also install these.
|
||||||
That said, some distros package `bundler` and `irb` separately. Make sure that
|
|
||||||
you also install these.
|
|
||||||
|
|
||||||
On Arch, you will need:
|
On Arch, you will need:
|
||||||
|
|
||||||
- `ruby`
|
- `ruby`
|
||||||
- `ruby-bundler`
|
- `ruby-bundler`
|
||||||
- `ruby-irb`
|
- `ruby-irb`
|
||||||
|
@ -114,21 +109,17 @@ bundle exec rake db:setup
|
||||||
## Running Mastodon
|
## Running Mastodon
|
||||||
|
|
||||||
1. Run `export RAILS_ENV=development NODE_ENV=development`.
|
1. Run `export RAILS_ENV=development NODE_ENV=development`.
|
||||||
- Put these in your shell's .rc, or a script you can source if you want to \
|
- Put these in your shell's .rc, or a script you can source if you want to skip this step in the future.
|
||||||
skip this step in the future.
|
|
||||||
2. Run `bundle exec rake assets:precompile`.
|
2. Run `bundle exec rake assets:precompile`.
|
||||||
- If this explodes, complaining about `Hash`, you'll need to \
|
- If this explodes, complaining about `Hash`, you'll need to `export NODE_OPTIONS=--openssl-legacy-provider`.
|
||||||
`export NODE_OPTIONS=--openssl-legacy-provider`.
|
- After doing this, you will need to run `bundle exec rake assets:clobber` and then re-run `bundle exec rake assets:precompile`.
|
||||||
- After doing this, you will need to run `bundle exec rake assets:clobber` \
|
|
||||||
and then re-run `bundle exec rake assets:precompile`.
|
|
||||||
3. Run `foreman start`
|
3. Run `foreman start`
|
||||||
|
|
||||||
# Updates/Troubleshooting
|
# Updates/Troubleshooting
|
||||||
|
|
||||||
## RubyVM/DebugInspector Issues
|
## RubyVM/DebugInspector Issues
|
||||||
|
|
||||||
Still unable to fix. Circumvent by removing `better_errors` and
|
Still unable to fix. Circumvent by removing `better_errors` and `binding_of_caller` from Gemfile.
|
||||||
`binding_of_caller` from Gemfile.
|
|
||||||
|
|
||||||
Happy to troubleshoot with someone better with Ruby than us >_<'/.
|
Happy to troubleshoot with someone better with Ruby than us >_<'/.
|
||||||
|
|
||||||
|
@ -147,5 +138,6 @@ If this doesn't help, try:
|
||||||
|
|
||||||
Then re-run `foreman start`. No. We have no idea why this worked.
|
Then re-run `foreman start`. No. We have no idea why this worked.
|
||||||
|
|
||||||
If the above instructions don't work, please contact @Rin here, or \
|
# Need Help?
|
||||||
@tammy@social.treehouse.systems.
|
|
||||||
|
If the above instructions don't work, please contact @Rin here, or @tammy@social.treehouse.systems.
|
||||||
|
|
Loading…
Reference in New Issue