zelo72
/
documentation
mirror of https://github.com/mastodon/documentation
1
0
Fork 0
Code Issues 6 Releases Wiki Activity

fix: explain Postgres error when creating a dev environment (#815) 

This has tripped me up a few times, so having this in the documentation would save me a Google search. 🙂
This commit is contained in:
Nolan Lawson 2020-09-27 20:03:37 -07:00 committed by GitHub
parent 3811ae1068
commit 1124632417
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
content/en/dev/setup.md
View File

@ -19,6 +19,16 @@ In the development environment, Mastodon will use PostgreSQL as the currently si
> Please keep in mind, by default Mastodon will run on port 3000. If you configure a different port for it, the generated admin account will use that number.
If `rails db:setup` gives you the Postgres error:
ActiveRecord::NoDatabaseError: FATAL: role "your_user_name" does not exist
(where `your_user_name` is your username), then run:
sudo -u postgres createuser your_user_name --createdb
This will create the necessary Postgres user with the permission to create a database.
### Running {#running}
There are multiple processes that need to be run for the full set of Mastodon’s functionality, although they can be selectively omitted. To run all of them with just one command, you can install Foreman with `gem install foreman --no-document` and then use: