Hellnet & hellspawn update
File created: hellnet/hellage/admin [Diff]
-- /dev/null++ b/hellnet/hellage/admin
@@ -1 +1,14 @@
h1. How to run your own Hellage index
First, see [[use]] for installing Hellage.
Then, see [[/hellnet/hspawn/use#metatrees]] for information how to create your own meta key.
bc. $ hellage-genmeta mykey hackage
Where @mykey@ is your key alias and @hackage@ is your meta name.
This will download index and packages from [http://hackage.haskell.org] and store links in your meta. If download of certain package is stalled for too long, feel free to interrupt the program; next time it will start where it ended, only need to re-download index.
-- /dev/null++ b/hellnet/hellage/index
@@ -1 +1,5 @@
use - How to use it
admin - How to run your own mirror
Hellage is a distributed "Hackage":http://hackage.haskell.org/ haskell packages' repository mirror.
-- /dev/null++ b/hellnet/hellage/use
@@ -1 +1,69 @@
h1. How to use Hellage
This may be insanely difficult. Or not.
First, "install Hellnet":/hellnet/hspawn/build. If you manage it, the rest is simple:
bc. $ cabal install hellage
or, @git clone git://git.bitcheese.net/hellage && cd hellage && runghc Setup.hs install@ and have fun.
h2. Actually use it
First, you need to add at least one Hellnet node to your nodelist. You can use bitcheese.net:6666 for now.
bc. $ hell-nodes handshake bitcheese.net 6666
Then you need to run hellage daemon on your machine:
bc. $ hellage 8da7ec91e46c4b1444bd1b1a151a038a0544fad23266111a8a84178efb9499cb756a265bbe456bd9ec9ba309bf146f8453ba17201ff968e181e36b5efe54fc1f hackage
Here, *8da7ec...* is my encryption key ID and *hackage* is meta name of hellage. If you plan to use this (or any other) key often, you can create an alias:
bc. $ hell-meta alias add voker57_key 8da7ec91e46c4b1444bd1b1a151a038a0544fad23266111a8a84178efb9499cb756a265bbe456bd9ec9ba309bf146f8453ba17201ff968e181e36b5efe54fc1f
and then refer to this key as "voker57" everywhere:
bc. $ hellage voker57_key hackage
This command will run hellage on its default port, which is 6609. If you want to change it, run hellage with -p 64657.
*WARNING WARNING*: Currently hellage does not bind to localhost, thus anybody with access to port can use it. Use firewalls or whatever to protect.
Now, let's add hellage to cabal's sources:
bc. $ editor ~/.cabal/config
Search out the @remote-repo:@, comment it out and add hellage:
bc. -- remote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archive
Update the hellage index:
bc. $ wget http://localhost:6609/update -O- 2>/dev/null
If result is "Failed" then something went wrong and hellage won't work. Check node connectivity.
Then, run @cabal update@ to get package index:
bc. $ cabal update
If everything was OK, then you can download packages now:
bc. $ cabal install empty
Congratulations! You got hellage up and running.
* If you don't like to keep a terminal emulator constantly running, i suggest using "daemontools":http://packages.debian.org/sid/daemontools or "dtach":http://dtach.sourceforge.net/ or "screen":http://www.gnu.org/software/screen/ for daemonizing hellage.
* You can update hellage via hellage!
h2. Troubleshooting / Feedback
If you succeeded, or failed, in installing hellage by this manual, share your experience in "hellnet mailing list":http://groups.google.com/group/hellnet.
-- a/hellnet/hspawn/build++ b/hellnet/hspawn/build
@@ -2,11 +2,11 @@
Warning: this requires lot of magic
h2. Downloading Manually
Get the latest source from git: @git clone git://git.bitcheese.net/Hellnet@
Requirements are: "GHC":http://haskell.org/ghc 6.10 6.12 (didn't check with other compilers), "Cabal":http://haskell.org/cabal (you will have to install them manually, as described "here":http://book.realworldhaskell.org/read/installing-ghc-and-haskell-libraries.html) HTTP, Lucu, Crypto (these are Cabal packages, you can install them with @cabal install name@)
Once you have all those installed, Hellnet can be built with
@@ -17,6 +17,14 @@
On first stage, Cabal may complain about missing dependencies, you'll have to install them.
Alternatively, if you don't want to mess with Cabal, you can just run 'make', it will compile all the executables in current folder. They are static and can be safely moved.
h2. Via cabal
Hellnet is available on Hackage. To install it, you'll need working Cabal setup (see above). Then
bc. $ cabal install hellnet
And pray, since not all packages on hackage are ready for GHC 6.12 and you may have to patch them.
Now, to the next step, [[use]].
-- a/hellnet/hspawn/use++ b/hellnet/hspawn/use
@@ -51,7 +51,7 @@
And after short wait read the text of GPL.
h2(#metatrees). Meta trees
[[/hellnet/tech/metatrees|Meta trees]] are tool to publish named information to Hellnet and keep it updated. Authenticity of information is guaranteed via digital signatures.
-- a/hellnet/index++ b/hellnet/index
@@ -1,3 +1,9 @@
tech - descriptions of technologies used in Hellnet
hspawn - documentation related to Haskell implementation
protocols - protocols' documentation
crypto - cryptographic stuff used in Hellnet
hellage - distributed hackage mirror using Hellnet
Hellnet is a project to create simple, distributed, anonymous data sharing network.
You can see current state of matters on [[status]] page.