Mercurial > kallithea

comparison docs/setup.rst @ 2776:63e58ef80ef1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Merge beta branch into stable
author Marcin Kuzminski <marcin@python-works.com>
date Sun, 02 Sep 2012 21:19:54 +0200
parents 533a126dc9ab dfb15c8ee63f
children f7a52d548fd0
comparison
equal deleted inserted replaced
2301:9d097c2592d3 2776:63e58ef80ef1
31 This will prompt you for a "root" path. This "root" path is the location where 31 This will prompt you for a "root" path. This "root" path is the location where
32 RhodeCode will store all of its repositories on the current machine. After 32 RhodeCode will store all of its repositories on the current machine. After
33 entering this "root" path ``setup-rhodecode`` will also prompt you for a username 33 entering this "root" path ``setup-rhodecode`` will also prompt you for a username
34 and password for the initial admin account which ``setup-rhodecode`` sets 34 and password for the initial admin account which ``setup-rhodecode`` sets
35 up for you. 35 up for you.
36
37 setup process can be fully automated, example for lazy::
38
39 paster setup-rhodecode production.ini --user=marcink --password=secret --email=marcin@rhodecode.org --repos=/home/marcink/my_repos
40
36 41
37 - The ``setup-rhodecode`` command will create all of the needed tables and an 42 - The ``setup-rhodecode`` command will create all of the needed tables and an
38 admin account. When choosing a root path you can either use a new empty 43 admin account. When choosing a root path you can either use a new empty
39 location, or a location which already contains existing repositories. If you 44 location, or a location which already contains existing repositories. If you
40 choose a location which contains existing repositories RhodeCode will simply 45 choose a location which contains existing repositories RhodeCode will simply
525 listen 80; 530 listen 80;
526 server_name hg.myserver.com; 531 server_name hg.myserver.com;
527 access_log /var/log/nginx/rhodecode.access.log; 532 access_log /var/log/nginx/rhodecode.access.log;
528 error_log /var/log/nginx/rhodecode.error.log; 533 error_log /var/log/nginx/rhodecode.error.log;
529 534
535 # uncomment if you have nginx with chunking module compiled
536 # fixes the issues of having to put postBuffer data for large git
537 # pushes
538 #chunkin on;
539 #error_page 411 = @my_411_error;
540 #location @my_411_error {
541 # chunkin_resume;
542 #}
543
544 # uncomment if you want to serve static files by nginx
545 #root /path/to/installation/rhodecode/public;
546
530 location / { 547 location / {
531 try_files $uri @rhode; 548 try_files $uri @rhode;
532 } 549 }
533 550
534 location @rhode { 551 location @rhode {
680 697
681 698
682 Other configuration files 699 Other configuration files
683 ------------------------- 700 -------------------------
684 701
685 Some example init.d scripts can be found here, for debian and gentoo: 702 Some example init.d scripts can be found in init.d directory::
686 703
687 https://rhodecode.org/rhodecode/files/tip/init.d 704 https://secure.rhodecode.org/rhodecode/files/beta/init.d
688
689
690 Troubleshooting
691 ---------------
692
693 :Q: **Missing static files?**
694 :A: Make sure either to set the `static_files = true` in the .ini file or
695 double check the root path for your http setup. It should point to
696 for example:
697 /home/my-virtual-python/lib/python2.6/site-packages/rhodecode/public
698
699 |
700
701 :Q: **Can't install celery/rabbitmq**
702 :A: Don't worry RhodeCode works without them too. No extra setup is required.
703
704 |
705
706 :Q: **Long lasting push timeouts?**
707 :A: Make sure you set a longer timeouts in your proxy/fcgi settings, timeouts
708 are caused by https server and not RhodeCode.
709
710 |
711
712 :Q: **Large pushes timeouts?**
713 :A: Make sure you set a proper max_body_size for the http server.
714
715 |
716
717 :Q: **Apache doesn't pass basicAuth on pull/push?**
718 :A: Make sure you added `WSGIPassAuthorization true`.
719
720 For further questions search the `Issues tracker`_, or post a message in the
721 `google group rhodecode`_
722 705
723 .. _virtualenv: http://pypi.python.org/pypi/virtualenv 706 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
724 .. _python: http://www.python.org/ 707 .. _python: http://www.python.org/
725 .. _mercurial: http://mercurial.selenic.com/ 708 .. _mercurial: http://mercurial.selenic.com/
726 .. _celery: http://celeryproject.org/ 709 .. _celery: http://celeryproject.org/