icecast.xml.in 6.79 KB
Newer Older
Jack Moffitt's avatar
Jack Moffitt committed
1
<icecast>
2 3 4
    <!-- location and admin are two arbitrary strings that are e.g. visible
         on the server info page of the icecast web interface
         (server_version.xsl). -->
5
    <location>Earth</location>
6 7
    <admin>icemaster@localhost</admin>

8 9 10
    <limits>
        <clients>100</clients>
        <sources>2</sources>
11
        <queue-size>524288</queue-size>
12 13 14
        <client-timeout>30</client-timeout>
        <header-timeout>15</header-timeout>
        <source-timeout>10</source-timeout>
15 16 17
        <!-- If enabled, this will provide a burst of data when a client 
             first connects, thereby significantly reducing the startup 
             time for listeners that do substantial buffering. However,
18 19 20 21
             it also significantly increases latency between the source
             client and listening client.  For low-latency setups, you
             might want to disable this. -->
        <burst-on-connect>1</burst-on-connect>
22 23 24 25
        <!-- same as burst-on-connect, but this allows for being more
             specific on how much to burst. Most people won't need to
             change from the default 64k. Applies to all mountpoints  -->
        <burst-size>65535</burst-size>
26
    </limits>
Jack Moffitt's avatar
Jack Moffitt committed
27

28 29
    <authentication>
        <!-- Sources log in with username 'source' -->
30
        <source-password>hackme</source-password>
31
        <!-- Relays log in username 'relay' -->
32
        <relay-password>hackme</relay-password>
33 34 35 36 37 38

        <!-- Admin logs in with the username given below -->
        <admin-user>admin</admin-user>
        <admin-password>hackme</admin-password>
    </authentication>

39 40 41 42 43 44
    <!-- set the mountpoint for a shoutcast source to use, the default if not
         specified is /stream but you can change it here if an alternative is
         wanted or an extension is required
    <shoutcast-mount>/live.nsv</shoutcast-mount>
    -->

45 46
    <!-- Uncomment this if you want directory listings -->
    <!--
47 48 49
    <directory>
        <yp-url-timeout>15</yp-url-timeout>
        <yp-url>http://dir.xiph.org/cgi-bin/yp-cgi</yp-url>
50 51
    </directory>
     -->
Jack Moffitt's avatar
Jack Moffitt committed
52

53 54 55
    <!-- This is the hostname other people will use to connect to your server.
    It affects mainly the urls generated by Icecast for playlists and yp
    listings. -->
56
    <hostname>localhost</hostname>
Jack Moffitt's avatar
Jack Moffitt committed
57

58 59 60 61
    <!-- You may have multiple <listener> elements -->
    <listen-socket>
        <port>8000</port>
        <!-- <bind-address>127.0.0.1</bind-address> -->
62
        <!-- <shoutcast-mount>/stream</shoutcast-mount> -->
63 64 65 66 67 68 69
    </listen-socket>
    <!--
    <listen-socket>
        <port>8001</port>
    </listen-socket>
    -->

70 71 72 73
    <!--<master-server>127.0.0.1</master-server>-->
    <!--<master-server-port>8001</master-server-port>-->
    <!--<master-update-interval>120</master-update-interval>-->
    <!--<master-password>hackme</master-password>-->
74 75 76 77 78 79

    <!-- setting this makes all relays on-demand unless overridden, this is
         useful for master relays which do not have <relay> definitions here.
         The default is 0 -->
    <!--<relays-on-demand>1</relays-on-demand>-->

Michael Smith's avatar
Michael Smith committed
80 81
    <!--
    <relay>
82 83 84 85
        <server>127.0.0.1</server>
        <port>8001</port>
        <mount>/example.ogg</mount>
        <local-mount>/different.ogg</local-mount>
86
        <on-demand>0</on-demand>
87

88
        <relay-shoutcast-metadata>0</relay-shoutcast-metadata>
Michael Smith's avatar
Michael Smith committed
89 90
    </relay>
    -->
91

92
    <!-- Only define a <mount> section if you want to use advanced options,
93 94 95 96
	 like alternative usernames or passwords
    -->

    <!--
97
    <mount>
98
        <mount-name>/example-complex.ogg</mount-name>
99

100 101 102 103
        <username>othersource</username>
        <password>hackmemore</password>

        <max-listeners>1</max-listeners>
104
        <dump-file>/tmp/dump-example1.ogg</dump-file>
105
        <burst-size>65536</burst-size>
106
        <fallback-mount>/example2.ogg</fallback-mount>
Karl Heyes's avatar
Karl Heyes committed
107
        <fallback-override>1</fallback-override>
108
        <fallback-when-full>1</fallback-when-full>
109
        <intro>/example_intro.ogg</intro>
110
        <hidden>1</hidden>
Karl Heyes's avatar
Karl Heyes committed
111
        <no-yp>1</no-yp>
112 113
        <authentication type="htpasswd">
                <option name="filename" value="myauth"/>
114
                <option name="allow_duplicate_users" value="0"/>
115
        </authentication>
116 117
        <on-connect>/home/icecast/bin/stream-start</on-connect>
        <on-disconnect>/home/icecast/bin/stream-stop</on-disconnect>
118
    </mount>
119
    -->
120

121
    <!--
122 123 124 125 126 127 128
    <mount>
        <mount-name>/auth_example.ogg</mount-name>
        <authentication type="url">
            <option name="mount_add"       value="http://myauthserver.net/notify_mount.php"/>
            <option name="mount_remove"    value="http://myauthserver.net/notify_mount.php"/>
            <option name="listener_add"    value="http://myauthserver.net/notify_listener.php"/>
            <option name="listener_remove" value="http://myauthserver.net/notify_listener.php"/>
129 130
            <option name="headers"         value="x-pragma,x-token"/>
            <option name="header_prefix"   value="ClientHeader."/>
131 132
        </authentication>
    </mount>
133
    -->
134

135
    <fileserve>1</fileserve>
136

137
    <paths>
138
        <!-- basedir is only used if chroot is enabled -->
139
        <basedir>@pkgdatadir@</basedir>
140 141 142

        <!-- Note that if <chroot> is turned on below, these paths must both
             be relative to the new root, not the original root -->
143
        <logdir>@localstatedir@/log/@PACKAGE@</logdir>
144 145
        <webroot>@pkgdatadir@/web</webroot>
        <adminroot>@pkgdatadir@/admin</adminroot>
146
        <!-- <pidfile>@pkgdatadir@/icecast.pid</pidfile> -->
147 148 149 150 151 152

        <!-- Aliases: treat requests for 'source' path as being for 'dest' path
             May be made specific to a port or bound address using the "port"
             and "bind-address" attributes.
          -->
        <!--
153
        <alias source="/foo" destination="/bar"/>
154
          -->
155 156 157 158
        <!-- Aliases: can also be used for simple redirections as well,
             this example will redirect all requests for http://server:port/ to
             the status page
          -->
159
	<alias source="/" destination="/status.xsl"/>
160
    </paths>
Jack Moffitt's avatar
Jack Moffitt committed
161

162 163 164
    <logging>
        <accesslog>access.log</accesslog>
        <errorlog>error.log</errorlog>
165
        <!-- <playlistlog>playlist.log</playlistlog> -->
166
      	<loglevel>3</loglevel> <!-- 4 Debug, 3 Info, 2 Warn, 1 Error -->
167 168 169 170 171 172 173
      	<logsize>10000</logsize> <!-- Max size of a logfile -->
        <!-- If logarchive is enabled (1), then when logsize is reached
             the logfile will be moved to [error|access|playlist].log.DATESTAMP,
             otherwise it will be moved to [error|access|playlist].log.old.
             Default is non-archive mode (i.e. overwrite)
        -->
        <!-- <logarchive>1</logarchive> -->
174 175 176 177 178 179 180 181
    </logging>

    <security>
        <chroot>0</chroot>
        <!--
        <changeowner>
            <user>nobody</user>
            <group>nogroup</group>
182
        </changeowner>
183 184
        -->
    </security>
Jack Moffitt's avatar
Jack Moffitt committed
185
</icecast>