a2server/docs/ivanx/index.md

## A2SERVER

A2SERVER lets you use a [Raspberry Pi][1], or almost any other computer, to
serve files to Apple IIgs and enhanced IIe computers on your network. You'll
also be able to boot into GS/OS or ProDOS 8 directly from tne network (no
drives needed). A2SERVER has been designed to be as easy to set up and use as
possible, and it's free.

<!--
A2SERVER is available as a Raspberry Pi installer, or a virtual machine which
runs on Mac OS X, Windows, Linux, or Solaris computers, or as an easy-to-use
installer for Ubuntu or Debian Linux.
-->

 A2SERVER is based on open-source software, primarily [Netatalk][2] 2.2.4,
 with [many utilities and enhancements](a2server_features.md) to make
 everything as easy as possible. (If you like A2SERVER, you might also want to
 check out [A2CLOUD][3].)

<!--
If you haven't checked out A2SERVER in a while: it now runs on something
small, cheap, and silent, and every common LocalTalk-to-Ethernet bridge now
works easily with a IIgs (as opposed to none previously). And A2SERVER
supports Wi-Fi, and can download and install GS/OS on your network drive for
you. Cool stuff!
-->

*Update 19-Mar-15: A2SERVER 1.2.2 is available. It has support for Raspberry
Pi 2 Model B and every other Raspberry Pi, and new command line options for
the installer script. To update, type `a2server-setup`.*

Choose how you'd like to use A2SERVER, and you'll be up and running shortly.

 * [Raspberry Pi](a2server_raspberrypi.md)
 * [Virtual Machine](a2server_virtualbox.md) (for Mac OS X, Windows, Linux,
   Solaris)
 * [Installer for Ubuntu or Debian Linux](a2server_installer.md)


Once you've got it set up, here are next steps:

[Attach your Apple II to your local network](a2server_lan.md)

[Connect to A2SERVER from your Apple II](a2server_howtouse.md)

[Boot into ProDOS 8 or GS/OS over the network](a2server_netboot.md)

[Log into, shut down, and do stuff in the A2SERVER
console](a2server_commands.md)

[Access A2SERVER files from a Mac or Windows computer](a2server_access.md)

[Use A2SERVER with Wi-Fi](a2server_wifi.md)


And some other stuff that might (or might not) be helpful or interesting:

[A2SERVER feature list](a2server_features.md)

[A2SERVER version history](update/versionhistory.txt)

[Recover from a crashed A2SERVER](a2server_recovery.md)

[Details of what the "a2server-setup" script
does](a2server_scriptdetails.md)

[See the March 2013 cover of Juiced.GS][4], featuring A2SERVER

[Watch me introduce A2SERVER at KansasFest 2011][5] (note: this contains some
outdated information)

[The A2SERVER odyssey](a2server_story.md) (warning: long)


Buckets of thanks to Steven Hirsch and Geoff Body, whose invaluable assistance
and contributions have made A2SERVER exist, along with Tony Diaz, Antoine
Vignau, Peter Wong, Martin Haye, Ken Gagne, Peter Neubauer, Anthony Martino,
James Littlejohn, and others at comp.sys.apple2 and KansasFest. (As well as
the creators, past and present, of Netatalk and Raspberry Pi.) Apple II
Forever!

Questions? Comments? email [ivan@ivanx.com](mailto:ivan@ivanx.com)

[Apple II Extravaganza home page](http://appleii.ivanx.com/)


[1]: http://www.raspberrypi.org
[2]: http://netatalk.sourceforge.net
[3]: http://ivanx.com/a2cloud
[4]: http://juiced.gs/2013/03/v18i1-now-shipping/
[5]: http://www.youtube.com/watch?v=w88NjWRK7Kk
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00			`## A2SERVER`

Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`A2SERVER lets you use a [Raspberry Pi][1], or almost any other computer, to`
Fix stray backslashes 2015-10-28 02:54:32 +00:00			`serve files to Apple IIgs and enhanced IIe computers on your network. You'll`
Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`also be able to boot into GS/OS or ProDOS 8 directly from tne network (no`
			`drives needed). A2SERVER has been designed to be as easy to set up and use as`
Fix stray backslashes 2015-10-28 02:54:32 +00:00			`possible, and it's free.`
Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00
			`<!--`
			`A2SERVER is available as a Raspberry Pi installer, or a virtual machine which`
			`runs on Mac OS X, Windows, Linux, or Solaris computers, or as an easy-to-use`
			`installer for Ubuntu or Debian Linux.`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00			`-->`

Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`A2SERVER is based on open-source software, primarily [Netatalk][2] 2.2.4,`
			`with [many utilities and enhancements](a2server_features.md) to make`
			`everything as easy as possible. (If you like A2SERVER, you might also want to`
			`check out [A2CLOUD][3].)`

			`<!--`
			`If you haven't checked out A2SERVER in a while: it now runs on something`
			`small, cheap, and silent, and every common LocalTalk-to-Ethernet bridge now`
			`works easily with a IIgs (as opposed to none previously). And A2SERVER`
			`supports Wi-Fi, and can download and install GS/OS on your network drive for`
			`you. Cool stuff!`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00			`-->`

A little more cleanup of the Markdown 2015-11-05 12:43:05 +00:00			`*Update 19-Mar-15: A2SERVER 1.2.2 is available. It has support for Raspberry`
			`Pi 2 Model B and every other Raspberry Pi, and new command line options for`
			the installer script. To update, type `a2server-setup`.*
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix stray backslashes 2015-10-28 02:54:32 +00:00			`Choose how you'd like to use A2SERVER, and you'll be up and running shortly.`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`* [Raspberry Pi](a2server_raspberrypi.md)`
Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`* [Virtual Machine](a2server_virtualbox.md) (for Mac OS X, Windows, Linux,`
			`Solaris)`
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`* [Installer for Ubuntu or Debian Linux](a2server_installer.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00

Fix stray backslashes 2015-10-28 02:54:32 +00:00			`Once you've got it set up, here are next steps:`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Attach your Apple II to your local network](a2server_lan.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Connect to A2SERVER from your Apple II](a2server_howtouse.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Boot into ProDOS 8 or GS/OS over the network](a2server_netboot.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`[Log into, shut down, and do stuff in the A2SERVER`
			`console](a2server_commands.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Access A2SERVER files from a Mac or Windows computer](a2server_access.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Use A2SERVER with Wi-Fi](a2server_wifi.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00

			`And some other stuff that might (or might not) be helpful or interesting:`

Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[A2SERVER feature list](a2server_features.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
			`[A2SERVER version history](update/versionhistory.txt)`

Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Recover from a crashed A2SERVER](a2server_recovery.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix stray backslashes 2015-10-28 02:54:32 +00:00			`[Details of what the "a2server-setup" script`
Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`does](a2server_scriptdetails.md)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
			`[See the March 2013 cover of Juiced.GS][4], featuring A2SERVER`

Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`[Watch me introduce A2SERVER at KansasFest 2011][5] (note: this contains some`
			`outdated information)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[The A2SERVER odyssey](a2server_story.md) (warning: long)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00

Cleanup of all markdown files produced so far 2015-10-22 19:45:46 +00:00			`Buckets of thanks to Steven Hirsch and Geoff Body, whose invaluable assistance`
			`and contributions have made A2SERVER exist, along with Tony Diaz, Antoine`
			`Vignau, Peter Wong, Martin Haye, Ken Gagne, Peter Neubauer, Anthony Martino,`
			`James Littlejohn, and others at comp.sys.apple2 and KansasFest. (As well as`
			`the creators, past and present, of Netatalk and Raspberry Pi.) Apple II`
			`Forever!`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00
			`Questions? Comments? email [ivan@ivanx.com](mailto:ivan@ivanx.com)`

Fix relative links .html -> .md There's little reason to render these files as HTML again, and if they're ever placed on a website, it'd probably be best to do so using a quick bit of PHP that does the translation on the fly. I'd suggest an absolutely trivial stylesheet for each page (more or less akin to the pre-HTML4 tags that were already present) and perhaps a tiny bit of script magic that regenerates those tags based on that CSS. Not a priority at present. 2015-10-22 19:21:51 +00:00			`[Apple II Extravaganza home page](http://appleii.ivanx.com/)`
Ivan's main A2SERVER page 2015-10-22 11:13:33 +00:00

			`[1]: http://www.raspberrypi.org`
			`[2]: http://netatalk.sourceforge.net`
			`[3]: http://ivanx.com/a2cloud`
			`[4]: http://juiced.gs/2013/03/v18i1-now-shipping/`
			`[5]: http://www.youtube.com/watch?v=w88NjWRK7Kk`