Initial commit
[0share.git] / doc / README
blob4bc6329f46b0942cf4200040f36526b2324072bf
1 0share - peer-to-peer sharing of Zero Install packages
3 Copyright Thomas Leonard, 2008
6 INTRODUCTION
8 Zero Install is a decentralised installation system. Meta-data about each
9 package is published in a "feed" file.
11 Before downloading a package over the internet, 0launch can check to see if
12 any nearby machines have a copy, and get it from them instead if so. This
13 will normally be much faster. The secure hash from the feed is used to check
14 that the software hasn't been modified.
17 INSTRUCTIONS
19 You will need to have enabled sharing within the computer first (before you can
20 share over the network). See:
22   http://0install.net/sharing.html
24 Then, to allow other machines to get software from yours, run this command and
25 leave it running:
27   $ sudo -u nobody 0launch http://0install.net/2008/interfaces/0share.xml
29 We run it as the "nobody" user for extra security, since it requires only read
30 access to the Zero Install cache (/var/cache/0install.net/implementations/).
32 Normally, you will want to run this automatically when the computer starts.
34 An easy way to do this is to put this line in /etc/crontab:
36 @reboot nobody 0launch http://0install.net/2008/interfaces/0share.xml
39 CONDITIONS
41 This library is free software; you can redistribute it and/or
42 modify it under the terms of the GNU Lesser General Public
43 License as published by the Free Software Foundation; either
44 version 3 of the License, or (at your option) any later version.
46 This library is distributed in the hope that it will be useful,
47 but WITHOUT ANY WARRANTY; without even the implied warranty of
48 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
49 Lesser General Public License for more details.
51 You should have received a copy of the GNU Lesser General Public
52 License along with this library; if not, write to the Free Software
53 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
56 BUG REPORTS
58 Please report any bugs to the mailing list:
60         http://0install.net/support.html