Compare commits

..

2 Commits

Author SHA1 Message Date
fox 493ac414e4 add "Need Help" header
ci/woodpecker/pr/woodpecker Pipeline was successful Details
ci/woodpecker/push/woodpecker Pipeline was successful Details
2022-12-09 23:02:18 -06:00
fox fa0ad184c9 remove 80 character line limit 2022-12-09 23:01:29 -06:00
1 changed files with 10 additions and 18 deletions

View File

@ -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.