from small one page howto to huge articles all in one place

search text in:




Other .linuxhowtos.org sites: www.linuxhowtos.org
toolsntoys.linuxhowtos.org



Last additions:
How to make X listen on port 6000

How to make X listen on port 6000

words:

34

views:

85684

userrating:

average rating: 1.2 (52 votes) (1=very good 6=terrible)


May, 25th 2007:
April, 26th 2007:
Apr, 10th. 2007:
Druckversion . pdf icon
You are here: Tutorials per portage category->net-misc->openssh

Create a chrooted ssh user

This tutorial explains how to install and configure a chroot enviroment for an ssh user. This setup enables you to give out ssh accounts without having to fear that this user can see all files on the system.

Installing ssh

First you need to have a patched version of the sshd server. Luckily these patches can be enabled with the use flag "chroot" in the sshd use flags.
#echo "net-misc/openssh chroot" >> /etc/portage/package.use
#emerge openssh

creating the chroot enviroment

We will create our chroot enviroment in /home/chroot.
To make the chroot work, run the following commands to make the needed directories and devices for the chrooted user.
mkdir /home/chroot/
mkdir /home/chroot/home/
cd /home/chroot
mkdir etc
mkdir bin
mkdir lib
mkdir usr
mkdir usr/bin
mkdir dev
mknod dev/null c 1 3
mknod dev/zero c 1 5

Now we need to populate the directories with some binaries.
copy the following script into a file. If you need more apps, add them
to the APPS line.

APPS="/bin/bash /bin/ls /bin/mkdir /bin/mv /bin/pwd /bin/rm /usr/bin/id /usr/bin/ssh /bin/ping /usr/bin/dircolors"
for prog in $APPS; do
cp $prog ./$prog

# obtain a list of related libraries
ldd $prog > /dev/null
if [ "$?" = 0 ] ; then
LIBS=`ldd $prog | awk '{ print $3 }'`
for l in $LIBS; do
mkdir ./`dirname $l` > /dev/null 2>&1
cp $l ./$l
done
fi
done

After you have run the script, your chroot enviroment is almost done.
run

cp /lib/libnss_compat.so.2 /lib/libnsl.so.1 /lib/libnss_files.so.2 ./lib/
echo '#!/bin/bash' > usr/bin/groups
echo "id -Gn" >> usr/bin/groups
touch etc/passwd
grep /etc/passwd -e "^root" > etc/passwd
to copy some libraries and user information into the chroot.
You should also copy the line of the group in which you will create new users from /etc/group to /home/chroot/etc/group. In this tutorial we will create users in the group users, so we do this:
grep /etc/group -e "^root" -e "^users" > etc/group

and restart SSH:
/etc/init.d/ssh restart

Creating chrooted users

ssh decides which user should be chrooted and which not by the "home directory" entry in the /etc/passwd.
Example for a non-chrooted user:
user_a:x:2002:100:User A:/home/user_a:/bin/bash
This user will be chrooted:
user_b:x:2003:100:User B:/home/chroot/./home/user_b:/bin/bash
Now lets add a testuser to the chrooted user list:
useradd -s /bin/bash -m -d /home/chroot/./home/testuser -c "testuser" -g users testuser

Then we give testuser a password:
passwd testuser

Finally, we have to copy the line for testuser in /etc/passwd to /home/chroot/etc/passwd:
grep /etc/passwd -e "^testuser" >> /home/chroot/etc/passwd


Now log in as testuser and see if everything worked.

Have fun
back



Support us on Content Nation

New Packages

- as rdf newsfeed
- as rss newsfeed
- as Atom newsfeed
2026-06-08
coredns - 1.14.3
Ebuild name:

net-dns/coredns-1.14.3

Description

CoreDNS is a DNS server that chains plugins

Added to portage

2026-06-08

gcc - 17.0.0_p20260607
Ebuild name:

sys-devel/gcc-17.0.0_p20260607

Description

The GNU Compiler Collection

Added to portage

2026-06-08

git-sources - 7.1_rc7
Ebuild name:

sys-kernel/git-sources-7.1_rc7

Description

The very latest -git version of the Linux kernel

Added to portage

2026-06-08

qbe - 1.3-r1
Ebuild name:

sys-devel/qbe-1.3-r1

Description

Pure-C embeddable compiler backend

Added to portage

2026-06-08

2026-06-07
ParmEd - 4.3.1
Ebuild name:

sci-chemistry/ParmEd-4.3.1

Description

Parameter and topology file editor and molecular mechanical simulator en

Added to portage

2026-06-07

flask-cors - 6.0.3
Ebuild name:

dev-python/flask-cors-6.0.3

Description

A Flask extension for Cross Origin Resource Sharing (CORS)

Added to portage

2026-06-07

gap - 4.16.0
Ebuild name:

sci-mathematics/gap-4.16.0

Description

System for computational discrete algebra (core functionality)

Added to portage

2026-06-07

gcc - 15.2.1_p20260605
Ebuild name:

sys-devel/gcc-15.2.1_p20260605

Description

The GNU Compiler Collection

Added to portage

2026-06-07

gcc - 16.1.1_p20260606
Ebuild name:

sys-devel/gcc-16.1.1_p20260606

Description

The GNU Compiler Collection

Added to portage

2026-06-07

gopls - 0.22.0
Ebuild name:

dev-go/gopls-0.22.0

Description

Added to portage

2026-06-07

highs - 1.14.0-r3
Ebuild name:

sci-mathematics/highs-1.14.0-r3

Description

Modern solver for linear, quadratic, and mixed-integer programs

Added to portage

2026-06-07

hydrus - 670
Ebuild name:

media-gfx/hydrus-670

Description

A booru-like media organizer for the desktop

Added to portage

2026-06-07

kid3 - 3.10.0
Ebuild name:

media-sound/kid3-3.10.0

Description

Simple tag editor based on Qt

Added to portage

2026-06-07

kitty - 0.47.2
Ebuild name:

x11-terms/kitty-0.47.2

Description

Fast, feature-rich, GPU-based terminal

Added to portage

2026-06-07

kitty-shell-integration - 0.47.2
Ebuild name:

x11-terms/kitty-shell-integration-0.47.2

Description

Shell integration scripts for kitty, a GPU-based terminal

Added to portage

2026-06-07

kitty-terminfo - 0.47.2
Ebuild name:

x11-terms/kitty-terminfo-0.47.2

Description

Terminfo for kitty, a GPU-based terminal emulator

Added to portage

2026-06-07

less - 704
Ebuild name:

sys-apps/less-704

Description

Excellent text file viewer

Added to portage

2026-06-07

logrotate - 3.22.0-r1
Ebuild name:

app-admin/logrotate-3.22.0-r1

Description

Rotates, compresses, and mails system logs

Added to portage

2026-06-07

logrotate - 9999
Ebuild name:

app-admin/logrotate-9999

Description

Rotates, compresses, and mails system logs

Added to portage

2026-06-07

mapserver - 8.6.4
Ebuild name:

sci-geosciences/mapserver-8.6.4

Description

Development environment for building spatially enabled webapps

Added to portage

2026-06-07

markdown-mode - 2.8
Ebuild name:

app-emacs/markdown-mode-2.8

Description

Major mode for editing Markdown-formatted text files

Added to portage

2026-06-07

mastodon - 2.0.7
Ebuild name:

app-emacs/mastodon-2.0.7

Description

Emacs client for Mastodon, federated microblogging social network

Added to portage

2026-06-07

moto - 5.2.2
Ebuild name:

dev-python/moto-5.2.2

Description

Mock library for boto

Added to portage

2026-06-07

mutter - 49.6
Ebuild name:

x11-wm/mutter-49.6

Description

GNOME compositing window manager based on Clutter

Added to portage

2026-06-07

phpBB - 3.3.17
Ebuild name:

www-apps/phpBB-3.3.17

Description

An open-source PHP-based bulletin board package

Added to portage

2026-06-07

plplot - 5.15.0_p15-r2
Ebuild name:

sci-libs/plplot-5.15.0_p15-r2

Description

Multi-language scientific plotting library

Added to portage

2026-06-07

propka - 3.5.1-r1
Ebuild name:

sci-chemistry/propka-3.5.1-r1

Description

pKa-value prediction of ionizable groups in protein and protein-ligan

Added to portage

2026-06-07

protobuf-go - 1.36.11
Ebuild name:

dev-go/protobuf-go-1.36.11

Description

Go support for Google's protocol buffers

Added to portage

2026-06-07

pysam - 0.24.0
Ebuild name:

sci-biology/pysam-0.24.0

Description

Python interface for the SAM/BAM sequence alignment and mapping format

Added to portage

2026-06-07

pysiril - 0.0.17
Ebuild name:

sci-astronomy/pysiril-0.0.17

Description

Python library to interface Python to a SiriL script

Added to portage

2026-06-07

rebar - 3.27.0
Ebuild name:

dev-util/rebar-3.27.0

Description

A sophisticated build-tool for Erlang projects that follows OTP principles

Added to portage

2026-06-07

sh - 2.2.4
Ebuild name:

dev-python/sh-2.2.4

Description

Python subprocess interface

Added to portage

2026-06-07

shotwell - 0.32.16
Ebuild name:

media-gfx/shotwell-0.32.16

Description

Open source photo manager for GNOME

Added to portage

2026-06-07

soundfile - 0.14.0
Ebuild name:

dev-python/soundfile-0.14.0

Description

audio library based on libsndfile, CFFI and NumPy

Added to portage

2026-06-07

structlog - 26.1.0
Ebuild name:

dev-python/structlog-26.1.0

Description

Structured Logging for Python

Added to portage

2026-06-07

zensical - 0.0.41
Ebuild name:

dev-python/zensical-0.0.41

Description

A modern static site generator by the Material for MkDocs team

Added to portage

2026-06-07

rdf newsfeed | rss newsfeed | Atom newsfeed
Copyright 2004-2025 Sascha Nitsch Unternehmensberatung GmbH
- Copyright and legal notices -
Time to create this page: 57.3 ms