r326 - /website/trunk/FAQ.mdwn

[camrdale-guest at users.alioth.debian.org]

Author: camrdale-guest
Date: Sun Jan  6 06:44:05 2008
New Revision: 326

URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=326
Log:
web commit by http://camrdale.myopenid.com/: Add some hints for hosting repositories via DebTorrent.

Modified:
    website/trunk/FAQ.mdwn

Modified: website/trunk/FAQ.mdwn
URL: http://svn.debian.org/wsvn/debtorrent/website/trunk/FAQ.mdwn?rev=326&op=diff
==============================================================================
--- website/trunk/FAQ.mdwn (original)
+++ website/trunk/FAQ.mdwn Sun Jan  6 06:44:05 2008
@@ -113,6 +113,44 @@
 
 ---
 
+### Hosting a Repository
+
+#### Do I need to do anything special?
+
+Not really. DebTorrent builds on the HTTP repository idea that is used
+extensively in Debian. There are many packages available that make
+setting up a repository quite easy. For example: 
+[reprepro][43] and [debmirror][44].
+
+Once you have an HTTP repository, you can ask that your users install
+DebTorrent and change their sources.list files as described in [[Install]].
+
+[43]: http://mirrorer.alioth.debian.org/
+[44]: http://packages.debian.org/unstable/net/debmirror
+
+#### Can I only offer packages via DebTorrent?
+
+At this point, DebTorrent usually requires an HTTP mirror to be available,
+which prevents the need for having seeds (packages which can't be found in
+peers are downloaded using HTTP from the mirror).
+
+If you want to only allow DebTorrent users to download from your HTTP
+mirror, you could deny access to all but the DebTorrent user-agent.
+Here are [some instructions][47] to do this in apache. It's not
+completely reliable, but should prevent most people from accessing your
+mirror directly. The user-agent DebTorrent uses is something like:
+`DebTorrent/T-0.1.4.1`.
+
+If you're not willing to setup an HTTP mirror, you need to make sure
+there's always a peer connected that has all the packages (a seed), and
+is accessible to all downloading peers. That could be quite difficult,
+as if there are more than about 50 peers, there's no guarantee that your
+seed will be connected to all of them.
+
+[47]: http://httpd.apache.org/docs/2.2/howto/access.html#env
+
+---
+
 ### Troubleshooting
 
 #### Installing a package fails? No torrents are running?