AMule Project FAQ - User contributions [en]

Webserver-1.2.x

2005-07-10T20:06:22Z

Shakraw: =Connecting to amuleweb=

=== Webserver with [[aMule]] 1.2.8 or earlier ===

The following is based on the original instruction by BigBob. They guide you on how to modify [[aMule]]'s configuration files to set [[aMuleWeb]] correctly.<br>
There is "Preferences"->"Remote Controls" now, but anyway, information is never a bad idea.

*Shutdown [[aMule]] to avoid overwritting config files while shutting down.

*Copy from [[aMule]]'s sources (version 1.2.4 or later) the directory ''src/webserver/'' into your ''~/.aMule/webserver/'' directory.

*Copy from [[aMule]]'s sources (version 1.2.4 or later) the file ''src/aMule.tmpl'' into your ''~/.aMule/aMule.tmpl'' directory.

*Open a terminal and type (you might have to install ''[http://www.delorie.com/gnu/docs/textutils/md5sum.1.html md5sum]''):

:''echo -n "'''THEPASWORDYOUWANT'''" | md5sum | cut -d " " -f 1''
:This command will reply with an [[MD4 hash|MD5 hash]]. Something like: 324f85f6095f9e5fe25b6c85af44b445

*Edit your ''~/.eMule'' file, locate the ''[ExternalConnect]'' section in it and change this fields:

:''AcceptExternalConnections=1'' <- To enable [[aMule]] to listen for [[External Connections]].
:''ECUseTCPPort=0'' <- Set this to 1 to use the [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. If disabled [[External Connections]] will fail!!
:''ECPort=4712'' <- Put here the port on which you want [[aMule]] to listen for [[External Connections]].
:''ECPassword=39e5049d0614baf21906500e2261d500'' <- Put here the password for [[External Connections]]<nowiki>'</nowiki> authentications you generated before in terminal (something like 324f85f6095f9e5fe25b6c85af44b445).

*Edit your ''~/.eMule'' file, locate the ''[WebServer]'' section in it and change fields:

:''Password=324f85f6095f9e5fe25b6c85af44b445'' <- Put here the password generated with [http://www.delorie.com/gnu/docs/textutils/md5sum.1.html md5sum] for the admin (full privileged users).
:''PasswordLow=1db5a746266e941b3ef7dd3586863ca7'' <- Put here the password generated with [http://www.delorie.com/gnu/docs/textutils/md5sum.1.html md5sum] for "low users" (low privileged users).
:''Port=10000'' <- Put the port you want [[aMuleWeb]] to listen on.
:''Enabled=1'' <- This option has been deprecated and is completly ignored now. Enabling External Connections will enable any application it connects to it, including [[aMuleWeb]].
:''UseGzip=1'' <- Enable compression on communication.
:''PageRefreshTime=120'' <- Put here the web page refresh time (in seconds).
:''UseLowRightsUser=0'' <- 0/1 (disabled/enabled) "low user" access.

*Restart [[aMule]].

*Once [[aMule]] is running, start the web interface ([[aMuleWeb]]).

*Now point your web browser to http://localhost:10000 (or whatever your host and ports are) and authenticate yourself with "Password" (for full privileged user) or "PasswordLow" (for low privileged user, if enabled).

*That's all :)

:'''NOTE:'' In latest [[aMule]] 1.2.x releases, the option ''WebTemplateFile'' allows to override the file template to use (thanks to [[User:Stefanero|Stefanero]]. You can set this option in the ''[eMule]]'' section. Example:

:''WebTemplateFile=eMule.tmpl''

== Connecting to [[aMuleWeb|amuleweb]] ==

To run [[aMuleWeb]] run ''<b>amuleweb</b>'' on a terminal. For more information about running [[aMuleWeb]] check the [[aMuleWeb|aMuleWeb document]].

Once [[aMuleWeb]] is running, open a web browser and connect to:

''http://host:port''

where ''host'' stands for your host's name (try with ''localhost'') and port stands for the [[aMuleWeb]] port ('''NOT''' the [[External Connections]] port).

For example: ''http://localhost:4711''

''Shakraw''

Webserver-1.2.x

2005-07-10T20:02:17Z

Shakraw: =Connecting to amuleweb=