coLinux
Register
m (8 revisions)
(fix broken link.)
Tag: Visual edit
 
(20 intermediate revisions by 13 users not shown)
Line 1: Line 1:
<!-- '''GettingStarted''' -->
 
 
[http://www.colinux.org/ coLinux] is a wonderful tool for running Linux under Windows; it allows you to run a full-fledged Linux computer with no extra partitions, inside Windows. More information can be found at the [http://colinux.sourceforge.net/ home page].
 
[http://www.colinux.org/ coLinux] is a wonderful tool for running Linux under Windows; it allows you to run a full-fledged Linux computer with no extra partitions, inside Windows. More information can be found at the [http://colinux.sourceforge.net/ home page].
   
= Disclaimers =
 
   
[http://www.colinux.org/ coLinux] is still under heavy development, and will likely change in the future. This page represents the contributions of various coLinux users. The information may not be tailored to your environment. Like many open source projects, there's no warranty, blah blah blah. There is no guarantee that this program will operate correctly, or indeed, at all.
 
   
  +
{| class="toc" id="toc" style="border-top-style: solid; border-right-style: solid; border-bottom-style: solid; border-left-style: solid; border-top-color: rgb(217, 217, 217); border-right-color: rgb(217, 217, 217); border-bottom-color: rgb(217, 217, 217); border-left-color: rgb(217, 217, 217); "
  +
|
  +
=Disclaimers=
  +
[http://www.colinux.org/ coLinux] is still under heavy development, and will likely change in the future. This page represents the contributions of various coLinux users. The information may not be tailored to your environment. Like many open source projects, there's no warranty, blah blah blah. There is no guarantee that this program will operate correctly, or indeed, at all.
  +
=coLinux 0.6.4 and before with [http://colinux.wikia.com/wiki/Configuration_file_format XML configuration]=
  +
Old coLinux versions up to 0.6.4 used an [http://colinux.wikia.com/wiki/Configuration_file_format XML file] as configuration. We put the old guide [http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&oldid=5023 here].
   
  +
The current manual should have only the new plain text formats for version 0.7.1 and later.
=The most IMPORTANT thing to know First=
 
   
On Microsoft Vista the following actions in this article under the sub-heading above will not work or may not work because as far as I know Microsoft Vista does not have a ms-dos based command prompt program. (COMMENT - The current version of Vista on my desktop DOES have an MS DOS shell. It is still under cmd.exe as it was under XP).
 
   
If you are running any version of Microsoft Windows XP or any older Microsoft Windows operating system, clicking on colinux-daemon.exe to open colinux will not work
 
(the program flashes and then disappears)
 
   
For those new to *NIX (Note: *NIX is often used to denote UNIX or UNIX-like operating systems) here is a definition of a "Command Shell". "Command shell" is the technical name for MS-DOS or other program that looks, acts and runs in a similar way to command prompt on Microsoft Windows. You will have to use a command shell program on your operating system (In Windows XP, the program file is called cmd.exe. On older versions of Microsoft Windows just use the command prompt program which is also known by the names of command prompt, MS-DOS or just dos to start colinux.
 
 
If you are not an experienced Microsoft Windows user, or do not know how to use Microsoft's command prompt program or cygwin, you must learn how to execute (start a program) with your command shell program to be able to open colinux. Or try one of the [[Installation out of the box]].
 
   
 
=Terminology=
 
=Terminology=
  +
;Host OS
 
;Hosting OS: The system coLinux is installed on (usually Windows)
+
:The system coLinux is installed on (usually Windows)
  +
;coLinux OS
;coLinux OS: A coLinux instance running an operating system like Debian, Ubuntu, or Gentoo
 
  +
:A coLinux instance running an operating system like Debian, Ubuntu, or Gentoo
;Adapter: Also called a "networking card". A piece of hardware which provides networking capabilites to a system
 
  +
;Adapter
 
  +
:Also called a "network card". A piece of hardware which provides network capabilites to a system
= Overview =
 
  +
=Overview=
 
 
'''Generally''', to use coLinux, one performs the following steps:
 
'''Generally''', to use coLinux, one performs the following steps:
   
*Download coLinux and run installation
+
*Download and install coLinux
 
*Use the included terminal to log in
 
*Use the included terminal to log in
 
*Use the most foolproof method to get network connectivity (usually slirp)
 
*Use the most foolproof method to get network connectivity (usually slirp)
Line 37: Line 34:
 
*use scp, putty, cofs/smb, etc., to copy files between Host and Guest
 
*use scp, putty, cofs/smb, etc., to copy files between Host and Guest
   
= Download and Installation =
 
   
See also [http://colinux.svn.sourceforge.net/svnroot/colinux/branches/stable/RUNNING README] on SourceForge.
 
   
  +
=Download and Installation=
Go to the [http://sourceforge.net/projects/colinux/files Downloads] on SourceForge.
 
  +
See Also [http://colinux.wikia.com/wiki/README README]
Download and run the most recent executable installer.
 
   
  +
Go to the [http://sourceforge.net/projects/colinux/files/ downloads] sourceforge downloads page. Download and run the most recent executable installer from package [http://sourceforge.net/project/showfiles.php?group_id=98788 &amp;package_id=107317 coLinux-stable].
# Although the installer doesn't default to it, "c:\coLinux" is a good install location.
 
# During the install you are prompted to install [[WinPcap]]. This can be done with the coLinux installer open, or later.
 
# The TAP-Win32 Virtual Adapter device driver will be installed.
 
# There is harm in installing both WinPcap and TAP-Win32.
 
   
  +
#Although the installer doesn't default to it, "c:\coLinux" is a good install location.
For the latest development binaries and source, see [http://colinux.org/snapshots/ snapshots]
 
  +
#During the install you are prompted to install [http://colinux.wikia.com/wiki/WinPcap WinPcap]. This can be done while the coLinux installer is open.
  +
#The TAP-Win32 Virtual Adapter device driver will be installed.
  +
#There is no harm in installing both WinPcap and TAP-Win32.
  +
For the latest development binaries and source (i.e. might crash your system), see [http://colinux.org/snapshots/ snapshots]
   
* [[StepByStepInXP]]
+
*[http://colinux.wikia.com/wiki/StepByStepInXP StepByStepInXP]
* [[TAP-Win32 driver]]
+
*[http://colinux.wikia.com/wiki/TAP-Win32_driver TAP-Win32 driver]
* [[TAP-Win32_driver#Tapcontrol.exe_-_On_the_command_line|tapcontrol.exe]] can be used to test, install, upgrade and remove the tap driver from the command line.
+
*[http://colinux.wikia.com/wiki/TAP-Win32_driver#Tapcontrol.exe_-_On_the_command_line tapcontrol.exe] can be used to test, install, upgrade and remove the tap driver from the command line.
  +
If you uninstall coLinux from one location and install it to another, the following procedure will update the Windows registry accordingly:
  +
colinux-daemon.exe --remove-driver
  +
colinux-daemon.exe --install-driver
   
If you uninstall coLinux from one location and install it to another, the following procedure will update the Windows driver accordingly:
 
   
<pre><nowiki>
 
colinux-daemon.exe --remove-driver
 
colinux-daemon.exe --install-driver
 
</nowiki></pre>
 
   
== Filesystem Download ==
+
=Filesystem Download=
  +
From the main download site, download an image file which includes an operating system. Debian-3.0r2.ext3-mit-backports.1gb.bz2 on [http://prdownloads.sourceforge.net/colinux/Debian-3.0r2.ext3-mit-backports.1gb.bz2?download SourceForge] is a good choice. It expands to 1GB when decompressed. This has a basic Debian image on it with everything you need to get started. Save/extract this in the coLinux directory. Here is a partial list of programs that can extract the image, which is compressed using bzip2:
   
From the main download site, also download a filesystem which includes an operating system. Debian-3.0r2.ext3-mit-backports.1gb.bz2 on [http://prdownloads.sourceforge.net/colinux/Debian-3.0r2.ext3-mit-backports.1gb.bz2?download SourceForge] is a good choice. It expands to 1GB when decompressed. This has a basic Debian image on it with everything you need to get started. Save/extract this in the coLinux directory. Here is a partial list of programs which can extract the image, which is compressed using bzip2:
 
 
*bzip2 for windows on [ftp://sources.redhat.com/pub/bzip2/v102/bzip2-102-x86-win32.exe redhat]
 
*bzip2 for windows on [ftp://sources.redhat.com/pub/bzip2/v102/bzip2-102-x86-win32.exe redhat]
*tar and bunzip2, included in [http://unxutils.sf.net/ unxutils] or in [http://www.cygwin.com cygwin]
+
*bzip2 for Windows, from [http://gnuwin32.sourceforge.net/packages/bzip2.htm GnuWin32] or [https://sourceforge.net/projects/getgnuwin32 GetGnuWin32]
  +
*tar and bunzip2, included in [http://unxutils.sf.net/ unxutils] or [http://www.cygwin.com/ cygwin]
 
*winrar
 
*winrar
 
*[http://www.7-zip.org/ 7Zip]
 
*[http://www.7-zip.org/ 7Zip]
 
 
Run bzip2 on Windows command line:
 
Run bzip2 on Windows command line:
<pre><nowiki>bzip2-102-x86-win32.exe -d Debian-3.0r2.ext3-mit-backports.1gb.bz2</nowiki></pre>
+
bzip2-102-x86-win32.exe -d Debian-3.0r2.ext3-mit-backports.1gb.bz2
   
= Configuration =
 
   
  +
coLinux can be configured using parameters on the '''command line''', or with a
 
  +
=Configuration=
'''configuration file''' like default.conf. These are very similar in syntax. For command-line options, see [http://colinux.svn.sourceforge.net/svnroot/colinux/branches/stable/doc/colinux-daemon colinux-daemon.txt] on your installation directory.
 
  +
coLinux can be configured using parameters on the '''command line''', or with a '''configuration file''' like default.colinux.xml. For command-line options, see [http://colinux.wikia.com/wiki/README README].
   
 
Here are the contents on an example file called coLinux.bat ("^" is the line continuation character in Windows).:
 
Here are the contents on an example file called coLinux.bat ("^" is the line continuation character in Windows).:
   
'''Uses eth0 as <u>SLiRP</u> for simplest Internet connectivity and eth1 to talk to Hosting OS'''
+
'''Uses eth1 to talk to Hosting OS, eth0 for for Internet connectivity'''
  +
colinux-daemon.exe kernel=vmlinux initrd=initrd.gz ^
<pre><nowiki>
 
  +
cobd0="Debian-20040605-mit.ext3.1610mb" ^
colinux-daemon.exe kernel=vmlinux initrd=initrd.gz
 
  +
cobd1="fs_768Mb" ^
cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
 
  +
mem=512 ^
cobd1="fs_768Mb"
 
  +
eth0=pcap-bridge,"Local Area Connection" ^
mem=512
 
  +
eth1=tuntap ^
eth0=slirp
 
  +
root=/dev/cobd0
eth1=tuntap
 
  +
'''Use ssh (port 22) or VNC (port 5901) to connect to coLinux guest system'''
root=/dev/cobd0
 
  +
colinux-daemon kernel=vmlinux ^
</nowiki></pre>
 
  +
cobd0=Debian-"c:\coLinux\20040605-mit.ext3.1610mb" ^
 
  +
cobd1="c:\coLinux\fs_768Mb" ^
'''Uses eth0 for <u>bridged</u> Internet connectivity and eth1 to talk to Hosting OS'''
 
  +
mem=512 ^
<pre><nowiki>
 
  +
eth0=slirp,,tcp:22:22/tcp:5901:5901 ^
colinux-daemon.exe kernel=vmlinux initrd=initrd.gz
 
  +
eth1=tuntap ^
cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
 
  +
root=/dev/cobd0
cobd1="fs_768Mb"
 
  +
The option''' cobd0''' represents a partition. Partitions are mounted under /dev/cobdn, where n is given by the index passed to it, and the path is fairly straightforward. Make sure that the first one (index="0") points to your root filesystem (e.g., the Debian image).
mem=512
 
  +
cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
eth0=pcap-bridge,"Local Area Connection",00:ff:75:39:D3:C1
 
  +
You may want to disable the swap device for now. It's not strictly necessary, and will be described later. It's no problem, if the file does not exist at this point:
eth1=tuntap
 
  +
cobd1="c:\coLinux\swap_file"
root=/dev/cobd0
 
</nowiki></pre>
 
 
'''Use ssh (port 22) or VNC (port 5901) to connect to coLinux guest system via <u>SLiRP port forwardings</u>, eth1 is still usable on host only'''
 
<pre><nowiki>
 
colinux-daemon kernel=vmlinux
 
cobd0=Debian-"c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
 
cobd1="c:\coLinux\fs_768Mb"
 
mem=512
 
eth0=slirp,,tcp:22:22/tcp:5901:5901
 
eth1=tuntap
 
root=/dev/cobd0
 
</nowiki></pre>
 
 
The "cobd" options represent partitions. They are actually mounted under /dev/cobdn, where n is given by the index passed to it, and the path is fairly straightforward. Make sure that the first one (index="0") points to your root filesystem (e.g., the Debian image).
 
 
<pre><nowiki>
 
cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
 
</nowiki></pre>
 
 
You may want to disable the swap device for now; it's not strictly necessary and will be described later.
 
 
Remove the line <code>cobd1="c:\coLinux\swap_device"</code> from your batch file or config file.
 
 
 
The other options will work as-is.
 
The other options will work as-is.
  +
==Memory [http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=8][http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=8 Edit]==
 
== Memory ==
 
 
 
You can take a quick look at the
 
You can take a quick look at the
  +
mem=64
<pre><nowiki>
 
  +
line and adjust it to fit your system. This is the physical amount of RAM you are going to allocate to coLinux, and you need to keep some for Windows.
mem=64
 
  +
{| border="1" cellpadding="3" cellspacing="0" style="border-top-width: 1px; border-right-width: 1px; border-bottom-width: 1px; border-left-width: 1px; "
</nowiki></pre>
 
  +
!System Memory
line and adjust it to fit your system. This is the physical amount of RAM you are going to allocate to [[coLinux]], and you need to keep some for Windows.
 
  +
!Suggested Memory Setting for coLinux
  +
|-
  +
|128MB RAM or less
  +
|Don't bother with coLinux. Well, OK, try 32MB...
  +
|-
  +
|160 to 256MB RAM
  +
|64MB
  +
|-
  +
|256 to 512MB RAM
  +
|96MB
  +
|-
  +
|512MB or more
  +
|128MB or more
  +
|}
  +
Those values are based on personal experience; your mileage may vary. Note: This is non-swappable memory, so using too much can do bad things to your computer while coLinux is running. (as soon as you reboot, everything will be fine). It used to default to 29MB which was sufficient for most things, now it seems to default to 64MB. If you have less than 256MB of RAM you probably want to make it smaller. Realistically, unless you want to use X Windows (described later) or use a very memory-intensive program, 32MB or even 16MB may be enough.
   
  +
Oh, if you want, you can also tell coLinux your keyboard is not US with a command line like loadkeys fr-latin1. (For remapping your keyboard check [http://colinux.wikia.com/wiki/CoLinuxKBD coLinuxKBD])
<table border=1 cellspacing="0" cellpadding="3" style="border-width:1px">
 
<tr><th>System Memory</th><th>Suggested Memory Setting for coLinux</th></tr>
 
<tr><td>128MB RAM or less</td><td>Don't bother with [[coLinux]]. Well, OK, try 32MB...</td></tr>
 
<tr><td>160 to 256MB RAM</td><td>64MB</td></tr>
 
<tr><td>256 to 512MB RAM</td><td>128MB</td></tr>
 
<tr><td>512MB or more</td><td>256MB or more</td></tr>
 
</table>
 
   
  +
Configuring the network. This is not strictly necessary to enjoy coLinux, but you need it to:
Those values are based on personal experience; your mileage may vary. Note: This is non-swappable memory, so using too much can do bad things to your computer (while coLinux is running; as soon as you reboot, everything will be fine). It used to default to 29MB which was sufficient for most things, now it seems to default to 64MB. If you have less than 256MB of RAM you probably want to make it smaller. Realistically, unless you want to use X Windows (described later) or use a very memory-intensive program, 32MB or even 16MB may be enough.
 
   
  +
*download new software: the image you downloaded contains only a basic system, much like a bare Windows installation
Oh, if you want, you can also tell [[coLinux]] your keyboard is not US with a command line like <code>loadkeys fr-latin1</code>. (For remapping your keyboard check [[coLinuxKBD]])
 
  +
*Use ssh and PuTTY, a nice terminal since you will find the console too uncomfortable
  +
*launch X applications and run VNC and see the results on your Windows screen
   
Then you have to configure the network. This is not strictly necessary to enjoy [[coLinux]] but you need it to:
 
* download new software: the image you downloaded contains only a basic system, much like a bare Windows installation
 
* use ssh and PuTTY, a nice terminal since you will find the console too uncomfortable
 
* launch X applications and run VNC and see the results on your Windows screen
 
   
= Running coLinux =
 
ok I have so little experience with ms-dos that I need to know how to actually get colinux up and running specifically on cmd.exe from winxp that starts from the Windows 'Home' path.
 
   
  +
=Running coLinux=
<pre><nowiki>
 
C:\Documents and Settings\my user name> cd \coLinux
+
c:\>cd coLinux
C:\coLinux> colinux-daemon.exe @example.conf
+
c:\coLinux>colinux-daemon.exe @example.conf
  +
or, to use an NT type command shell as the terminal:
</nowiki></pre>
 
  +
c:\coLinux>colinux-daemon.exe -t nt @example.conf
  +
*To enable a double-click start, create a short-cut to the daemon (right-click and select Create Shortcut), then right-click on that new shortcut and select Properties. In the Target box (under the Shortcut tab), add the following to the end of the existing text (after the double-quote): "@example.conf" and click OK. Don't forget the space before the @, Vista needs this in quotes! You can now double-click the shortcut (perhaps copy it to your desktop) to run CoLinux. If you would like to start the console minimised, select Minimized from the Run drop-down box.
  +
*Alternatively, you can put the following into a bat file such as coLinux.bat which you can double click:<br />start "coLinux" /Dc:\colinux /min colinux-daemon.exe @example.conf<br />Remove /min if you want to see the boot messages. Change the /D<path> to point to your coLinux dir.
  +
*In another few seconds, a colinux-console should pop up. And after a few more seconds, it should stop and give you a login prompt. Since the default Debian image has no other users, you must log in as root:
  +
*The login for the debian image is root/root, you should change this.
  +
:2.4 distros - blank password
  +
:2.6 distros - "root" as password
  +
Now you can use adduser to add another user for normal use, or passwd to set the root password. And you have Linux!
  +
==Brushing the Dust off a Downloaded Root FS [http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=10][http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=10 Edit]==
  +
The Debian Root filesystems are a little long in the tooth. [http://colinux.wikia.com/wiki/DebianRootFsImages DebianRootFsImages] is a procedure to bring the system up-to-date so that it is actually usable.
   
or, to use a command shell as the terminal:
 
   
<pre><nowiki>
 
C:\Documents and Settings\my user name> cd \coLinux
 
C:\coLinux> colinux-daemon.exe -t nt @example.conf
 
</nowiki></pre>
 
   
*Some errors can be disregarded. Currently, errors that will appear when running a correctly-installed coLinux:
 
   
  +
=Using Other Linux Distributions in coLinux=
<pre><nowiki>
 
  +
The vanilla Debian may not be to your liking, or it may just seem a little hard to set up. You can find the instructions for installing just about any 32bit distribution here: [http://colinux.wikia.com/wiki/Easy_way_to_port_native/vm_distro_to_coLinux Easy_way_to_port_native/vm_distro_to_coLinux], or for using an already installed dual boot distro (propably outdated) [http://colinux.wikia.com/wiki/ConvertingDistributions ConvertingDistributions]. If you would like to use the Gentoo Deluxe 2 GB image look here: [http://colinux.wikia.com/wiki/GentooDeluxHowto GentooDeluxHowto], or if you would like to use Topologi Linux look here:[http://colinux.wikia.com/wiki/TopoHowTo TopoHowTo]. You can also download via [http://colinux.wikia.com/wiki/BitTorrent BitTorrent] a [http://cwelug.org/~rwcitek/colinux/coLinux-0.6.0+Debian-3.0r0.ext3.1gb.exe.torrent pre-configured coLinux] setup based on coLinux-0.6.0 and the Debian filesystem - just download, extract, install, run.
Disabled Privacy Extensions on device c02bf040(lo)
 
eth0: duplicate address detected!
 
</nowiki></pre>
 
   
*To enable a double-click start, create a short-cut to the daemon (right-click and select Create Shortcut), and then right-click on that new shortcut and select Properties. In the Target box (under the Shortcut tab), add the following to the end of the existing text (after the double-quote, and don't forget the space before the @): <code>&nbsp;@example.conf</code> and click OK. You can now double-click the shortcut (perhaps copy it to your desktop) to run CoLinux. If you would like to start the console minimised, select Minimized from the Run drop-down box.
 
*Alternatively, you can put the following into a bat file such as coLinux.bat which you can double click:<br> <code>start "coLinux" /Dc:\colinux /min colinux-daemon.exe @example.conf</code><br> Remove /min if you want to see the boot messages.<br>Change the /D<path> to point to your coLinux dir.<br>
 
   
*The login for the debian image is root/root, you should change this.
 
 
In another few seconds, a colinux-console should pop up. And after a few more seconds, it should stop and give you a login prompt. Since the Debian image by default has no other users, you must log in as root:
 
 
* 2.4 distros - blank password
 
* 2.6 distros - "root" as password
 
 
Now you can use adduser to add another user for normal use, or passwd to set the root password. And you have Linux!
 
   
== Brushing the Dust off a Downloaded Root FS ==
 
   
  +
=Troubleshooting=
The Debian Root filesystems are a little long in the tooth. [[DebianRootFsImages]] is a procedure to bring the system up-to-date so that it is actually usable.
 
   
  +
<span style="background-color:transparent;font-size:20px;">coLinux doesn't start </span>[http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=13][http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=13 Edit]
== Troubleshooting ==
 
  +
*check the path to the uncompressed filesystem image
=== coLinux doesn't start ===
 
  +
*in the line with root=/dev/cobd0 add '''ro''' with space between:
* check the path to the uncompressed filesystem image
 
  +
root=/dev/cobd0 '''ro'''
* in the line with
 
  +
:and be ready to remove it if it doesn't help. You can keep it. It is harmless in most cases. (some distributions need it)
<pre><nowiki>
 
  +
*Finally, take a close look at your text editor. It may have converted the text silently to UTF-8, adding an invisible marker at the beginning of your configuration file. Switch to hexadecimal mode or to another editor and check the top of the file. If you see the UTF-8 marker, erase it.
root=/dev/cobd0
 
  +
*in case of an error similar to
</nowiki></pre>
 
  +
daemon: exit code 84a08401
:add <code>ro</code> after <code>root</code>:
 
  +
daemon: error - CO_RC_ERROR_ERROR, line 33, file colinux/os/current/user/file.o
<pre><nowiki>
 
root=/dev/cobd0
 
ro
 
</nowiki></pre>
 
:and be ready to remove it if it doesn't help. You can keep it. It is harmless in most cases (some distributions need it)
 
* finally, take a close look at your text editor. It may have converted the text silently to UTF-8, adding an invisible marker at the beginning of your configuration file. Switch to hexadecimal mode or to another editor and check the top of the file. If you see the UTF-8 marker, erase it.
 
*in case of a error similar to
 
<pre><nowiki>
 
daemon: exit code 84a08401
 
daemon: error - CO_RC_ERROR_ERROR, line 33,
 
file colinux/os/current/user/file.o
 
</nowiki></pre>
 
 
:Repeat the following dance:
 
:Repeat the following dance:
  +
colinux-daemon.exe --remove-driver
<pre><nowiki>
 
colinux-daemon.exe --remove-driver
+
colinux-daemon.exe --install-driver
colinux-daemon.exe --install-driver
 
</nowiki></pre>If that doesn't work you can check your parameters in the config-file. Look for an incorrect or missing image filename, vmlinux path, or swapfile path. Comment out all unneeded config-file parameters to see which might be incorrect.
 
   
  +
If that doesn't work, you can check your parameters in the config-file. Look for an incorrect or missing image filename, vmlinux path, or swapfile path. Comment out all unneeded config-file parameters to help find the cause of the problem.
* If none of these things work, you can try Nitin Jain's install notes<ref>[http://svn.sourceforge.net/viewvc/r-lpe/trunk/misc/coLinux/ Nitin Jain's install notes] 2006-07</ref>. Very good step-by-step directions
 
  +
*Add -v 3 to the colinux-daemon options, to see more verbose messages.
  +
*If none of these things work, you can try Nitin Jain's install notes (listed in External references). Very good step-by-step directions
  +
=Adding Swap Space=
  +
*To add swap for use in your coLinux environment you need a blank file with the correct size of swap you want. [http://gniarf.nerim.net/colinux/fs/ Here] is a location of a number of sizes of empty partitions.
  +
*Add the name of the file you downloaded, per the line below, to your configuration file (example.conf). Be sure to set the path too. cobd1=c:\coLinux\swap
  +
*Boot your coLinux system.
  +
*Login as root
  +
*Add the line below to /etc/fstab: /dev/cobd1 none swap sw 0 0
  +
*Run "mkswap /dev/cobd1"
  +
*Run "swapon -a"
  +
==Important Note for Gentoo Users [http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=15][http://colinux.wikia.com/index.php?title=Getting_Started_with_coLinux&action=edit&section=15 Edit]==
  +
Gentoo requires configuration of a swap file. Follow the instructions at [http://colinux.wikia.com/wiki/AddSwapPartition AddSwapPartition]
  +
=Network=
  +
see [http://colinux.wikia.com/wiki/Network#Recommended_Setup Network#Recommended_Setup]
   
  +
See [http://colinux.wikia.com/wiki/Network#The_WinPCAP_driver Network#The_WinPCAP_driver]
= Using Other Linux Distributions in coLinux =
 
   
  +
See [http://colinux.wikia.com/wiki/Network#TAP Network#TAP]
The vanilla Debian may not be to your liking, or it may just seem a little hard to set up. You can find the instructions for configuring a specific distribution to use coLinux here: [[ConvertingDistributions]]. If you would like to use the Gentoo Deluxe 2 GB image look here: [[GentooDeluxHowto]], or if you would like to use Topologi Linux look here: [[TopoHowTo]]. You can also download via [[BitTorrent]] a [http://cwelug.org/~rwcitek/colinux/coLinux-0.6.0+Debian-3.0r0.ext3.1gb.exe.torrent pre-configured coLinux] setup based on coLinux-0.6.0 and the Debian filesystem - just download, extract, install, run.
 
   
  +
See [http://colinux.wikia.com/wiki/Network#Slirp Network#Slirp]
More official image files can be find after selecting [http://sourceforge.net/project/showfiles.php?group_id=98788&package_id=122245 "View older releases in the Root FS Images - 2.6.x-based package"] on SourceForge file releases page.
 
  +
=Graphical Interface (Xserver)=
  +
The article [http://colinux.wikia.com/wiki/XCoLinux XCoLinux] explains how to run an X server on the Host and xclient applications in coLinux
   
  +
=External Resources=
= Adding Swap Space =
 
  +
:[http://svn.sourceforge.net/viewvc/r-lpe/trunk/misc/coLinux/ Nitin Jain's install notes ]2006-07.
To add swap for use in your coLinux environment you need a filesystem file with the correct size of swap you want. [http://gniarf.nerim.net/colinux/fs/ Here] is a location of a number of sizes of empty partitions. Name the file you downloaded per the line below in your default.conf file. Be sure to set the path too.
 
  +
:[http://www.tjhsst.edu/~edanaher/misc/colinux.html Evan Danaher's notes ]2005 or earlier.
<code>
 
  +
:[https://sites.google.com/site/philipschladt/home/4---colinux--debian coLinux+Debian on Windows XP-Pro install notes]2008-2019
cobd1=c:\coLinux\swap
 
</code>
 
# Boot into your coLinux system.
 
# Login as root
 
# Add the line below to /etc/fstab:<code> /dev/cobd1 none swap sw 0 0</code>
 
# Run "mkswap /dev/cobd1"
 
# Run "swapon -a"
 
   
  +
colinux-daemon.exe --remove-driver colinux-daemon.exe --install-driver
== Alternative way to get swap file ==
 
  +
= Filesystem Download = From the main download site, also download a filesystem which includes an operating system. Debian-3.0r2.ext3-mit-backports.1gb.bz2 on [http://prdownloads.sourceforge.net/colinux/Debian-3.0r2.ext3-mit-backports.1gb.bz2?download SourceForge] is a good choice. It expands to 1GB when decompressed. This has a basic Debian image on it with everything you need to get started. Save/extract this in the coLinux directory. Here is a partial list of programs which can extract the image, which is compressed using bzip2: *bzip2 for windows on [ftp://sources.redhat.com/pub/bzip2/v102/bzip2-102-x86-win32.exe redhat] *bzip2 for Windows, from [http://gnuwin32.sourceforge.net/packages/bzip2.htm GnuWin32] or [https://sourceforge.net/projects/getgnuwin32 GetGnuWin32] *tar and bunzip2, included in [http://unxutils.sf.net/ unxutils] or [http://www.cygwin.com cygwin] *winrar *[http://www.7-zip.org/ 7Zip] Run bzip2 on Windows command line:
You can create your own swap partition file if you have colinux installed - with the following command:
 
  +
bzip2-102-x86-win32.exe -d Debian-3.0r2.ext3-mit-backports.1gb.bz2
<code>
 
dd if=/dev/zero bs=1k count=512k of=swap_fs
 
</code>
 
   
  +
= Configuration = coLinux can be configured using parameters on the '''command line''', or with a '''configuration file''' like default.colinux.xml. For command-line options, see [[README]]. Here are the contents on an example file called coLinux.bat ("^" is the line continuation character in Windows).: '''Uses eth1 to talk to Hosting OS, eth0 for for Internet connectivity'''
The 512k will mean creating 512k blocks of 1k size - this is 512Mb of swap. Alter these numbers for more/less swap to suit your needs. It is recommended that it be at least twice the size of the memory you have configured colinux to use.
 
  +
colinux-daemon.exe kernel=vmlinux initrd=initrd.gz ^
  +
cobd0="Debian-20040605-mit.ext3.1610mb" ^
  +
cobd1="fs_768Mb" ^
  +
mem=512 ^
  +
eth0=pcap-bridge,"Local Area Connection" ^
  +
eth1=tuntap ^
  +
root=/dev/cobd0
   
  +
'''Use ssh (port 22) or VNC (port 5901) to connect to coLinux guest system'''
== Important Note for Gentoo Users ==
 
  +
colinux-daemon kernel=vmlinux ^
  +
cobd0=Debian-"c:\coLinux\20040605-mit.ext3.1610mb" ^
  +
cobd1="c:\coLinux\fs_768Mb" ^
  +
mem=512 ^
  +
eth0=slirp,,tcp:22:22/tcp:5901:5901 ^
  +
eth1=tuntap ^
  +
root=/dev/cobd0
   
  +
The option''' cobd0''' represents a partition. Partitions are mounted under /dev/cobdn, where n is given by the index passed to it, and the path is fairly straightforward. Make sure that the first one (index="0") points to your root filesystem (e.g., the Debian image).
Gentoo requires configuration of a swap file. Follow the instructions at [[AddSwapPartition]]
 
  +
cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"
   
  +
You may want to disable the swap device for now; it's not strictly necessary and will be described later. It's no problem, if the file does not exist at this point:
= Network =
 
  +
cobd1="c:\coLinux\swap_file"
   
  +
The other options will work as-is. == Memory == You can take a quick look at the
see [[Network#Recommended_Setup]]
 
  +
mem=64
   
  +
line and adjust it to fit your system. This is the physical amount of RAM you are going to allocate to coLinux, and you need to keep some for Windows.
See [[Network#The_WinPCAP_driver]]
 
  +
{| border="1" cellpadding="3" cellspacing="0" style="border-width:1px"
  +
!System Memory
  +
!Suggested Memory Setting for coLinux
  +
|-
  +
|128MB RAM or less
  +
|Don't bother with coLinux. Well, OK, try 32MB...
  +
|-
  +
|160 to 256MB RAM
  +
|64MB
  +
|-
  +
|256 to 512MB RAM
  +
|96MB
  +
|-
  +
|512MB or more
  +
|128MB or more
  +
|}
   
  +
Those values are based on personal experience; your mileage may vary. Note: This is non-swappable memory, so using too much can do bad things to your computer (while coLinux is running; as soon as you reboot, everything will be fine). It used to default to 29MB which was sufficient for most things, now it seems to default to 64MB. If you have less than 256MB of RAM you probably want to make it smaller. Realistically, unless you want to use X Windows (described later) or use a very memory-intensive program, 32MB or even 16MB may be enough. Oh, if you want, you can also tell coLinux your keyboard is not US with a command line like loadkeys fr-latin1. (For remapping your keyboard check [http://colinux.wikia.com/wiki/CoLinuxKBD coLinuxKBD]) Then you have to configure the network. This is not strictly necessary to enjoy coLinux, but you need it to: * download new software: the image you downloaded contains only a basic system, much like a bare Windows installation * use ssh and PuTTY, a nice terminal since you will find the console too uncomfortable * launch X applications and run VNC and see the results on your Windows screen = Running coLinux =
See [[Network#TAP]]
 
  +
c:\>cd coLinux
  +
c:\coLinux>colinux-daemon.exe @example.conf
   
  +
or, to use a command shell as the terminal:
See [[Network#Slirp]]
 
  +
c:\coLinux>colinux-daemon.exe -t nt @example.conf
  +
*To enable a double-click start, create a short-cut to the daemon (right-click and select Create Shortcut), and then right-click on that new shortcut and select Properties. In the Target box (under the Shortcut tab), add the following to the end of the existing text (after the double-quote): "@example.conf" and click OK. Don't forget the space before the @, Vista needs this in quotes! You can now double-click the shortcut (perhaps copy it to your desktop) to run CoLinux. If you would like to start the console minimised, select Minimized from the Run drop-down box. *Alternatively, you can put the following into a bat file such as coLinux.bat which you can double click:
   
  +
start "coLinux" /Dc:\colinux /min colinux-daemon.exe @example.conf
= Graphical Interface (Xserver) =
 
  +
Remove /min if you want to see the boot messages. Change the /D to point to your coLinux dir. *In another few seconds, a colinux-console should pop up. And after a few more seconds, it should stop and give you a login prompt. Since the Debian image by default has no other users, you must log in as root: *The login for the debian image is root/root, you should change this. : 2.4 distros - blank password : 2.6 distros - "root" as password Now you can use adduser to add another user for normal use, or passwd to set the root password. And you have Linux! == Brushing the Dust off a Downloaded Root FS == The Debian Root filesystems are a little long in the tooth. [[DebianRootFsImages]] is a procedure to bring the system up-to-date so that it is actually usable. = Using Other Linux Distributions in coLinux = The vanilla Debian may not be to your liking, or it may just seem a little hard to set up. You can find the instructions for installing just about any 32bit distribution here: [[Easy_way_to_port_native/vm_distro_to_coLinux]], or for using an already installed dual boot distro (propably outdated) [[ConvertingDistributions]]. If you would like to use the Gentoo Deluxe 2 GB image look here: [[GentooDeluxHowto]], or if you would like to use Topologi Linux look here: [[TopoHowTo]]. You can also download via [[BitTorrent]] a [http://cwelug.org/~rwcitek/colinux/coLinux-0.6.0+Debian-3.0r0.ext3.1gb.exe.torrent pre-configured coLinux] setup based on coLinux-0.6.0 and the Debian filesystem - just download, extract, install, run. = Troubleshooting = == coLinux doesn't start == * check the path to the uncompressed filesystem image * in the line with root=/dev/cobd0 add '''ro''' with space between: root=/dev/cobd0 '''ro''' :and be ready to remove it if it doesn't help. You can keep it. It is harmless in most cases (some distributions need it) * finally, take a close look at your text editor. It may have converted the text silently to UTF-8, adding an invisible marker at the beginning of your configuration file. Switch to hexadecimal mode or to another editor and check the top of the file. If you see the UTF-8 marker, erase it. *in case of a error similar to
 
  +
daemon: exit code 84a08401
The article [[XCoLinux]] explains how to run an X server on the Host and xclient applications in coLinux
 
  +
daemon: error - CO_RC_ERROR_ERROR, line 33, file colinux/os/current/user/file.o
 
  +
:Repeat the following dance:
= External Resources =
 
  +
colinux-daemon.exe --remove-driver
 
  +
colinux-daemon.exe --install-driver
<references />
 
: [http://www.tjhsst.edu/~edanaher/misc/colinux.html Evan Danaher's notes ] 2005 or earlier.
 
   
  +
If that doesn't work you can check your parameters in the config-file. Look for an incorrect or missing image filename, vmlinux path, or swapfile path. Comment out all unneeded config-file parameters to see which might be incorrect. *Add -v 3 to the colinux-daemon options, to see more verbose messages. * If none of these things work, you can try Nitin Jain's install notes (listed in External references). Very good step-by-step directions = Adding Swap Space = * To add swap for use in your coLinux environment you need a blank file with the correct size of swap you want. [http://gniarf.nerim.net/colinux/fs/ Here] is a location of a number of sizes of empty partitions. * Name the file you downloaded per the line below into your configuration file (example.conf). Be sure to set the path too.
: [http://tycho.homelinux.org/colinux/ Cristian Popescu's install and configuration notes - debian from scratch] from 2007
 
  +
cobd1=c:\coLinux\swap
:: - is for version 0.6.4 with changes for 0.7.1 and you can apply these notes to the latest version too.
 
  +
* Boot into your coLinux system. * Login as root * Add the line below to /etc/fstab:
  +
/dev/cobd1 none swap sw 0 0
  +
* Run "mkswap /dev/cobd1" * Run "swapon -a" == Important Note for Gentoo Users == Gentoo requires configuration of a swap file. Follow the instructions at [[AddSwapPartition]] = Network = see [[Network#Recommended_Setup]] See [[Network#The_WinPCAP_driver]] See [[Network#TAP]] See [[Network#Slirp]] = Graphical Interface (Xserver) = The article [[XCoLinux]] explains how to run an X server on the Host and xclient applications in coLinux = External Resources = :[http://svn.sourceforge.net/viewvc/r-lpe/trunk/misc/coLinux/ Nitin Jain's install notes ]2006-07. :[http://www.tjhsst.edu/~edanaher/misc/colinux.html Evan Danaher's notes ]2005 or earlier. :[https://sites.google.com/site/philipschladt/home/4---colinux--debian coLinux+Debian on Windows XP-Pro install notes]2008-2019
  +
|}

Latest revision as of 20:21, 13 June 2019

coLinux is a wonderful tool for running Linux under Windows; it allows you to run a full-fledged Linux computer with no extra partitions, inside Windows. More information can be found at the home page.


Disclaimers[]

coLinux is still under heavy development, and will likely change in the future. This page represents the contributions of various coLinux users. The information may not be tailored to your environment. Like many open source projects, there's no warranty, blah blah blah. There is no guarantee that this program will operate correctly, or indeed, at all.

coLinux 0.6.4 and before with XML configuration[]

Old coLinux versions up to 0.6.4 used an XML file as configuration. We put the old guide here.

The current manual should have only the new plain text formats for version 0.7.1 and later.



Terminology[]

Host OS
The system coLinux is installed on (usually Windows)
coLinux OS
A coLinux instance running an operating system like Debian, Ubuntu, or Gentoo
Adapter
Also called a "network card". A piece of hardware which provides network capabilites to a system

Overview[]

Generally, to use coLinux, one performs the following steps:

  • Download and install coLinux
  • Use the included terminal to log in
  • Use the most foolproof method to get network connectivity (usually slirp)
  • Update the system using apt-get or emerge
  • Install xterm or a complete desktop like GNOME or KDE
  • Install an X Server or VNC on the Host
  • use telnet, ssh, or a VNC client to connect to the Guest and start xterm, etc.
  • use scp, putty, cofs/smb, etc., to copy files between Host and Guest


Download and Installation[]

See Also README

Go to the downloads sourceforge downloads page. Download and run the most recent executable installer from package &package_id=107317 coLinux-stable.

  1. Although the installer doesn't default to it, "c:\coLinux" is a good install location.
  2. During the install you are prompted to install WinPcap. This can be done while the coLinux installer is open.
  3. The TAP-Win32 Virtual Adapter device driver will be installed.
  4. There is no harm in installing both WinPcap and TAP-Win32.

For the latest development binaries and source (i.e. might crash your system), see snapshots

If you uninstall coLinux from one location and install it to another, the following procedure will update the Windows registry accordingly:

colinux-daemon.exe --remove-driver
colinux-daemon.exe --install-driver


Filesystem Download[]

From the main download site, download an image file which includes an operating system. Debian-3.0r2.ext3-mit-backports.1gb.bz2 on SourceForge is a good choice. It expands to 1GB when decompressed. This has a basic Debian image on it with everything you need to get started. Save/extract this in the coLinux directory. Here is a partial list of programs that can extract the image, which is compressed using bzip2:

Run bzip2 on Windows command line:

bzip2-102-x86-win32.exe -d Debian-3.0r2.ext3-mit-backports.1gb.bz2


Configuration[]

coLinux can be configured using parameters on the command line, or with a configuration file like default.colinux.xml. For command-line options, see README.

Here are the contents on an example file called coLinux.bat ("^" is the line continuation character in Windows).:

Uses eth1 to talk to Hosting OS, eth0 for for Internet connectivity

colinux-daemon.exe kernel=vmlinux initrd=initrd.gz ^
cobd0="Debian-20040605-mit.ext3.1610mb" ^
cobd1="fs_768Mb" ^
mem=512 ^
eth0=pcap-bridge,"Local Area Connection" ^
eth1=tuntap ^
root=/dev/cobd0

Use ssh (port 22) or VNC (port 5901) to connect to coLinux guest system

colinux-daemon kernel=vmlinux ^
cobd0=Debian-"c:\coLinux\20040605-mit.ext3.1610mb" ^
cobd1="c:\coLinux\fs_768Mb" ^
mem=512 ^
eth0=slirp,,tcp:22:22/tcp:5901:5901 ^
eth1=tuntap ^
root=/dev/cobd0

The option cobd0 represents a partition. Partitions are mounted under /dev/cobdn, where n is given by the index passed to it, and the path is fairly straightforward. Make sure that the first one (index="0") points to your root filesystem (e.g., the Debian image).

cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"

You may want to disable the swap device for now. It's not strictly necessary, and will be described later. It's no problem, if the file does not exist at this point:

cobd1="c:\coLinux\swap_file"

The other options will work as-is.

Memory [1]Edit[]

You can take a quick look at the

mem=64

line and adjust it to fit your system. This is the physical amount of RAM you are going to allocate to coLinux, and you need to keep some for Windows.

System Memory Suggested Memory Setting for coLinux
128MB RAM or less Don't bother with coLinux. Well, OK, try 32MB...
160 to 256MB RAM 64MB
256 to 512MB RAM 96MB
512MB or more 128MB or more

Those values are based on personal experience; your mileage may vary. Note: This is non-swappable memory, so using too much can do bad things to your computer while coLinux is running. (as soon as you reboot, everything will be fine). It used to default to 29MB which was sufficient for most things, now it seems to default to 64MB. If you have less than 256MB of RAM you probably want to make it smaller. Realistically, unless you want to use X Windows (described later) or use a very memory-intensive program, 32MB or even 16MB may be enough.

Oh, if you want, you can also tell coLinux your keyboard is not US with a command line like loadkeys fr-latin1. (For remapping your keyboard check coLinuxKBD)

Configuring the network. This is not strictly necessary to enjoy coLinux, but you need it to:

  • download new software: the image you downloaded contains only a basic system, much like a bare Windows installation
  • Use ssh and PuTTY, a nice terminal since you will find the console too uncomfortable
  • launch X applications and run VNC and see the results on your Windows screen


Running coLinux[]

c:\>cd coLinux
c:\coLinux>colinux-daemon.exe @example.conf

or, to use an NT type command shell as the terminal:

c:\coLinux>colinux-daemon.exe -t nt @example.conf
  • To enable a double-click start, create a short-cut to the daemon (right-click and select Create Shortcut), then right-click on that new shortcut and select Properties. In the Target box (under the Shortcut tab), add the following to the end of the existing text (after the double-quote): "@example.conf" and click OK. Don't forget the space before the @, Vista needs this in quotes! You can now double-click the shortcut (perhaps copy it to your desktop) to run CoLinux. If you would like to start the console minimised, select Minimized from the Run drop-down box.
  • Alternatively, you can put the following into a bat file such as coLinux.bat which you can double click:
    start "coLinux" /Dc:\colinux /min colinux-daemon.exe @example.conf
    Remove /min if you want to see the boot messages. Change the /D<path> to point to your coLinux dir.
  • In another few seconds, a colinux-console should pop up. And after a few more seconds, it should stop and give you a login prompt. Since the default Debian image has no other users, you must log in as root:
  • The login for the debian image is root/root, you should change this.
2.4 distros - blank password
2.6 distros - "root" as password

Now you can use adduser to add another user for normal use, or passwd to set the root password. And you have Linux!

Brushing the Dust off a Downloaded Root FS [2]Edit[]

The Debian Root filesystems are a little long in the tooth. DebianRootFsImages is a procedure to bring the system up-to-date so that it is actually usable.



Using Other Linux Distributions in coLinux[]

The vanilla Debian may not be to your liking, or it may just seem a little hard to set up. You can find the instructions for installing just about any 32bit distribution here: Easy_way_to_port_native/vm_distro_to_coLinux, or for using an already installed dual boot distro (propably outdated) ConvertingDistributions. If you would like to use the Gentoo Deluxe 2 GB image look here: GentooDeluxHowto, or if you would like to use Topologi Linux look here:TopoHowTo. You can also download via BitTorrent a pre-configured coLinux setup based on coLinux-0.6.0 and the Debian filesystem - just download, extract, install, run.



Troubleshooting[]

coLinux doesn't start [3]Edit

  • check the path to the uncompressed filesystem image
  • in the line with root=/dev/cobd0 add ro with space between:
root=/dev/cobd0 ro
and be ready to remove it if it doesn't help. You can keep it. It is harmless in most cases. (some distributions need it)
  • Finally, take a close look at your text editor. It may have converted the text silently to UTF-8, adding an invisible marker at the beginning of your configuration file. Switch to hexadecimal mode or to another editor and check the top of the file. If you see the UTF-8 marker, erase it.
  • in case of an error similar to
daemon: exit code 84a08401
daemon: error - CO_RC_ERROR_ERROR, line 33, file colinux/os/current/user/file.o
Repeat the following dance:
colinux-daemon.exe --remove-driver
colinux-daemon.exe --install-driver

If that doesn't work, you can check your parameters in the config-file. Look for an incorrect or missing image filename, vmlinux path, or swapfile path. Comment out all unneeded config-file parameters to help find the cause of the problem.

  • Add -v 3 to the colinux-daemon options, to see more verbose messages.
  • If none of these things work, you can try Nitin Jain's install notes (listed in External references). Very good step-by-step directions

Adding Swap Space[]

  • To add swap for use in your coLinux environment you need a blank file with the correct size of swap you want. Here is a location of a number of sizes of empty partitions.
  • Add the name of the file you downloaded, per the line below, to your configuration file (example.conf). Be sure to set the path too. cobd1=c:\coLinux\swap
  • Boot your coLinux system.
  • Login as root
  • Add the line below to /etc/fstab: /dev/cobd1 none swap sw 0 0
  • Run "mkswap /dev/cobd1"
  • Run "swapon -a"

Important Note for Gentoo Users [4]Edit[]

Gentoo requires configuration of a swap file. Follow the instructions at AddSwapPartition

Network[]

see Network#Recommended_Setup

See Network#The_WinPCAP_driver

See Network#TAP

See Network#Slirp

Graphical Interface (Xserver)[]

The article XCoLinux explains how to run an X server on the Host and xclient applications in coLinux

External Resources[]

Nitin Jain's install notes 2006-07.
Evan Danaher's notes 2005 or earlier.
coLinux+Debian on Windows XP-Pro install notes2008-2019

colinux-daemon.exe --remove-driver colinux-daemon.exe --install-driver = Filesystem Download = From the main download site, also download a filesystem which includes an operating system. Debian-3.0r2.ext3-mit-backports.1gb.bz2 on SourceForge is a good choice. It expands to 1GB when decompressed. This has a basic Debian image on it with everything you need to get started. Save/extract this in the coLinux directory. Here is a partial list of programs which can extract the image, which is compressed using bzip2: *bzip2 for windows on redhat *bzip2 for Windows, from GnuWin32 or GetGnuWin32 *tar and bunzip2, included in unxutils or cygwin *winrar *7Zip Run bzip2 on Windows command line:

bzip2-102-x86-win32.exe -d Debian-3.0r2.ext3-mit-backports.1gb.bz2

= Configuration = coLinux can be configured using parameters on the command line, or with a configuration file like default.colinux.xml. For command-line options, see README. Here are the contents on an example file called coLinux.bat ("^" is the line continuation character in Windows).: Uses eth1 to talk to Hosting OS, eth0 for for Internet connectivity

colinux-daemon.exe kernel=vmlinux initrd=initrd.gz ^
cobd0="Debian-20040605-mit.ext3.1610mb" ^
cobd1="fs_768Mb" ^
mem=512 ^
eth0=pcap-bridge,"Local Area Connection" ^
eth1=tuntap ^
root=/dev/cobd0

Use ssh (port 22) or VNC (port 5901) to connect to coLinux guest system

colinux-daemon kernel=vmlinux ^
cobd0=Debian-"c:\coLinux\20040605-mit.ext3.1610mb" ^
cobd1="c:\coLinux\fs_768Mb" ^
mem=512 ^
eth0=slirp,,tcp:22:22/tcp:5901:5901 ^
eth1=tuntap ^
root=/dev/cobd0

The option cobd0 represents a partition. Partitions are mounted under /dev/cobdn, where n is given by the index passed to it, and the path is fairly straightforward. Make sure that the first one (index="0") points to your root filesystem (e.g., the Debian image).

cobd0="c:\coLinux\Debian-3.0r2.ext3-mit-backports.1gb"

You may want to disable the swap device for now; it's not strictly necessary and will be described later. It's no problem, if the file does not exist at this point:

cobd1="c:\coLinux\swap_file"

The other options will work as-is. == Memory == You can take a quick look at the

mem=64

line and adjust it to fit your system. This is the physical amount of RAM you are going to allocate to coLinux, and you need to keep some for Windows.

System Memory Suggested Memory Setting for coLinux
128MB RAM or less Don't bother with coLinux. Well, OK, try 32MB...
160 to 256MB RAM 64MB
256 to 512MB RAM 96MB
512MB or more 128MB or more

Those values are based on personal experience; your mileage may vary. Note: This is non-swappable memory, so using too much can do bad things to your computer (while coLinux is running; as soon as you reboot, everything will be fine). It used to default to 29MB which was sufficient for most things, now it seems to default to 64MB. If you have less than 256MB of RAM you probably want to make it smaller. Realistically, unless you want to use X Windows (described later) or use a very memory-intensive program, 32MB or even 16MB may be enough. Oh, if you want, you can also tell coLinux your keyboard is not US with a command line like loadkeys fr-latin1. (For remapping your keyboard check coLinuxKBD) Then you have to configure the network. This is not strictly necessary to enjoy coLinux, but you need it to: * download new software: the image you downloaded contains only a basic system, much like a bare Windows installation * use ssh and PuTTY, a nice terminal since you will find the console too uncomfortable * launch X applications and run VNC and see the results on your Windows screen = Running coLinux =

c:\>cd coLinux
c:\coLinux>colinux-daemon.exe @example.conf

or, to use a command shell as the terminal:

c:\coLinux>colinux-daemon.exe -t nt @example.conf
  • To enable a double-click start, create a short-cut to the daemon (right-click and select Create Shortcut), and then right-click on that new shortcut and select Properties. In the Target box (under the Shortcut tab), add the following to the end of the existing text (after the double-quote): "@example.conf" and click OK. Don't forget the space before the @, Vista needs this in quotes! You can now double-click the shortcut (perhaps copy it to your desktop) to run CoLinux. If you would like to start the console minimised, select Minimized from the Run drop-down box. *Alternatively, you can put the following into a bat file such as coLinux.bat which you can double click:

start "coLinux" /Dc:\colinux /min colinux-daemon.exe @example.conf Remove /min if you want to see the boot messages. Change the /D to point to your coLinux dir. *In another few seconds, a colinux-console should pop up. And after a few more seconds, it should stop and give you a login prompt. Since the Debian image by default has no other users, you must log in as root: *The login for the debian image is root/root, you should change this. : 2.4 distros - blank password : 2.6 distros - "root" as password Now you can use adduser to add another user for normal use, or passwd to set the root password. And you have Linux! == Brushing the Dust off a Downloaded Root FS == The Debian Root filesystems are a little long in the tooth. DebianRootFsImages is a procedure to bring the system up-to-date so that it is actually usable. = Using Other Linux Distributions in coLinux = The vanilla Debian may not be to your liking, or it may just seem a little hard to set up. You can find the instructions for installing just about any 32bit distribution here: Easy_way_to_port_native/vm_distro_to_coLinux, or for using an already installed dual boot distro (propably outdated) ConvertingDistributions. If you would like to use the Gentoo Deluxe 2 GB image look here: GentooDeluxHowto, or if you would like to use Topologi Linux look here: TopoHowTo. You can also download via BitTorrent a pre-configured coLinux setup based on coLinux-0.6.0 and the Debian filesystem - just download, extract, install, run. = Troubleshooting = == coLinux doesn't start == * check the path to the uncompressed filesystem image * in the line with root=/dev/cobd0 add ro with space between: root=/dev/cobd0 ro :and be ready to remove it if it doesn't help. You can keep it. It is harmless in most cases (some distributions need it) * finally, take a close look at your text editor. It may have converted the text silently to UTF-8, adding an invisible marker at the beginning of your configuration file. Switch to hexadecimal mode or to another editor and check the top of the file. If you see the UTF-8 marker, erase it. *in case of a error similar to

daemon: exit code 84a08401
daemon: error - CO_RC_ERROR_ERROR, line 33, file colinux/os/current/user/file.o
Repeat the following dance:
colinux-daemon.exe --remove-driver
colinux-daemon.exe --install-driver

If that doesn't work you can check your parameters in the config-file. Look for an incorrect or missing image filename, vmlinux path, or swapfile path. Comment out all unneeded config-file parameters to see which might be incorrect. *Add -v 3 to the colinux-daemon options, to see more verbose messages. * If none of these things work, you can try Nitin Jain's install notes (listed in External references). Very good step-by-step directions = Adding Swap Space = * To add swap for use in your coLinux environment you need a blank file with the correct size of swap you want. Here is a location of a number of sizes of empty partitions. * Name the file you downloaded per the line below into your configuration file (example.conf). Be sure to set the path too.

cobd1=c:\coLinux\swap
  • Boot into your coLinux system. * Login as root * Add the line below to /etc/fstab:
 /dev/cobd1  none swap sw 0 0