Code Repositories xandikos / 0189238
Merge instructions on deploying on heroku. Jelmer Vernooń≥ 2 years ago
2 changed file(s) with 64 addition(s) and 0 deletion(s). Raw diff Collapse all Expand all
0 [uwsgi]
1 http-socket = :$(PORT)
2 die-on-term = true
3 umask = 022
4 master = true
5 cheaper = 2
6 processes = 4
7 plugin = router_basicauth,python3
8 route = ^/ basicauth:myrealm,user1:password1
9 module = xandikos.wsgi:app
10 env = XANDIKOSPATH=$HOME/dav
11 env = CURRENT_USER_PRINCIPAL=/dav/user1/
12 env = AUTOCREATE=defaults
0 Running Xandikos on Heroku
1 ==========================
2
3 Heroku is an easy way to get a public instance of Xandikos running. A free
4 heroku instance comes with 100Mb of local storage, which is enough for
5 thousands of calendar items or contacts.
6
7 Deployment
8 ----------
9
10 All of these steps assume you already have a Heroku account and have installed
11 the heroku command-line client.
12
13 To run a Heroku instance with Xandikos:
14
15 1. Create a copy of Xandikos::
16
17 $ git clone git://jelmer.uk/xandikos xandikos
18 $ cd xandikos
19
20 2. Make a copy of the example uwsgi configuration:
21
22 $ cp examples/uwsgi-heroku.ini uwsgi.ini::
23
24 3. Edit *uwsgi.ini* as necessary, such as changing the credentials (the
25 defaults are *user1*/*password1*).
26
27 4. Set Heroku procfile to use uwsgi configuration::
28
29 $ echo web: uwsgi uwsgi.ini > Procfile
30
31 5. Add uwsgi to requirements::
32
33 $ echo uwsgi > requirements.txt
34
35 6. Create the Heroku instance::
36
37 $ heroku create
38
39 (this might ask you for your heroku credentials)
40
41 7. Deploy the app::
42
43 $ git push heroku master
44
45 8. Open the app with your browser::
46
47 $ heroku open
48
49 (The URL opened is also the URL that you can provide to any CalDAV/CardDAV
50 application that supports service discovery)