Template:Installation/Common: Difference between revisions
No edit summary |
(Add reverse proxy section to the bottom of the guide) |
||
| (108 intermediate revisions by 24 users not shown) | |||
| Line 1: | Line 1: | ||
== Get the source == | == Get the source == | ||
It's time to download | It's time to download diaspora*! As your diaspora user run: | ||
{{#tag:syntaxhighlight| | {{#tag:syntaxhighlight| | ||
cd ~ | cd ~ | ||
git clone {{#ifeq: {{#var:mode}}|production|-b | git clone {{#ifeq: {{#var:mode}}|production|-b main|}} https://github.com/diaspora/diaspora.git | ||
cd diaspora | cd diaspora | ||
|lang=bash}} | |lang=bash}} | ||
| Line 17: | Line 17: | ||
{{#tag:syntaxhighlight| | {{#tag:syntaxhighlight| | ||
cp config/database.yml.example config/database.yml | cp config/database.yml.example config/database.yml | ||
cp config/diaspora. | cp config/diaspora.toml.example config/diaspora.toml | ||
|lang=bash}} | |lang=bash}} | ||
{{#ifeq: {{#var:mode}}|production|{{ | {{#ifeq: {{#var:mode}}|production|{{Template:Installation/Configuration}}|}} | ||
== Bundle == | == Bundle == | ||
It's time to install the Ruby libraries required by | It's time to install the Ruby libraries required by diaspora*: | ||
{{#tag:syntaxhighlight| | {{#tag:syntaxhighlight| | ||
script/configure_bundler | |||
bin/bundle install --full-index | |||
|lang=bash}} | |lang=bash}} | ||
This takes quite a while. | This takes quite a while. When it's finished, you should see a message similar to: <tt>Bundle complete! 137 Gemfile dependencies, 259 gems now installed.</tt> If that's not the case, you should seek for help on the mailing list or the IRC channel. | ||
Running the manual <tt>gem install</tt> command shown in the error message can sometimes show a clearer error message if the <tt>bundle</tt> command fails. | |||
== Database setup == | == Database setup == | ||
| Line 38: | Line 40: | ||
{{#tag:syntaxhighlight| | {{#tag:syntaxhighlight| | ||
{{#var:env_string}} | {{#var:env_string}}bin/rake db:create db:migrate | ||
|lang=bash}} | |lang=bash}} | ||
{{#ifeq: {{#var:mode}}|production|{{Installation/Assets}}|}} | |||
== Start diaspora* == | |||
It's time to start diaspora*: | |||
= | {{#tag:syntaxhighlight| | ||
./script/server | |||
|lang="bash"}} | |||
Your diaspora server is now running, either on a unix socket (current default) or on http port 3000. The listening method can be configured in diaspora.toml, search for '3000' or 'listen' to find the correct line. | |||
{{#ifeq: {{#var:mode}}|production| | |||
. | The server script is good to ensure your server works as expected. You should set up [[Automatic_startup_methods|automatic startup]] for your pod, so that your pod automatically starts on server reboots, and recovers from eventual crashes. | ||
{{Installation/Reverse_proxy}} | |||
|}} | |||
== Backup == | |||
{{Serious|1=You have to do backups of your pod data. If you lose your data, you won't be able to use the combination of your old username and old domain ever again. Make sure to store the backups on a different server, or at least on a different hard drive.<br />For details on how to do backups, see [[Pod data backup]].}} | |||
== Further | == Further reading == | ||
* [[ | * [[Diasporas components explained]] | ||
* [[Integrating | * Is there anybody out there? [[FAQ_for_pod_maintainers#Am_I_alone_here.3F_.28Establish_connections_with_other_pods.29|Establish connections with other pods]] | ||
* [[FAQ_for_pod_maintainers#What_are_roles_and_how_do_I_use_them.3F_.2F_Make_yourself_an_admin_or_assign_moderators|Make yourself an admin]] | |||
* [[Updating#{{#switch: {{#var:mode}}|production=Updating_a_production_install|development=Updating_a_development_install}}|Updating Diaspora]] | |||
{{#ifeq: {{#var:mode}}|production|* [[Integrating other social networks]] | |||
* [[Alternative startup methods]] (Passenger, Init script, Daemontools, ...) | * [[Alternative startup methods]] (Passenger, Init script, Daemontools, ...) | ||
* [[ | * [[Asset hosting on S3]]|* [[Getting Started With Contributing]]|}} | ||
<includeonly> | |||
[[Category:Installation]] | |||
[[Category:Podmin]] | |||
</includeonly> | |||
<noinclude>[[Category:Installation-Templates]]</noinclude> | |||
Latest revision as of 23:11, 15 June 2024
Get the source
It's time to download diaspora*! As your diaspora user run:
cd ~
git clone https://github.com/diaspora/diaspora.git
cd diaspora
Don't miss the cd diaspora, all coming commands expect to be run from that directory!
Configuration
Copy files
cp config/database.yml.example config/database.yml
cp config/diaspora.toml.example config/diaspora.toml
Bundle
It's time to install the Ruby libraries required by diaspora*:
script/configure_bundler
bin/bundle install --full-index
This takes quite a while. When it's finished, you should see a message similar to: Bundle complete! 137 Gemfile dependencies, 259 gems now installed. If that's not the case, you should seek for help on the mailing list or the IRC channel.
Running the manual gem install command shown in the error message can sometimes show a clearer error message if the bundle command fails.
Database setup
Double check your config/database.yml looks right and run:
bin/rake db:create db:migrate
Start diaspora*
It's time to start diaspora*:
./script/server
Your diaspora server is now running, either on a unix socket (current default) or on http port 3000. The listening method can be configured in diaspora.toml, search for '3000' or 'listen' to find the correct line.
Backup
 Warning: | You have to do backups of your pod data. If you lose your data, you won't be able to use the combination of your old username and old domain ever again. Make sure to store the backups on a different server, or at least on a different hard drive. For details on how to do backups, see Pod data backup. |