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:

85522

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-03
2026-06-02
aiohttp - 3.14.0
Ebuild name:

dev-python/aiohttp-3.14.0

Description

HTTP client/server for asyncio

Added to portage

2026-06-02

awscli - 1.45.19
Ebuild name:

app-admin/awscli-1.45.19

Description

Universal Command Line Environment for AWS

Added to portage

2026-06-02

borgmatic - 2.1.6
Ebuild name:

app-backup/borgmatic-2.1.6

Description

Automatically create, prune and verify backups with borgbackup

Added to portage

2026-06-02

boto3 - 1.43.19
Ebuild name:

dev-python/boto3-1.43.19

Description

The AWS SDK for Python

Added to portage

2026-06-02

botocore - 1.43.19
Ebuild name:

dev-python/botocore-1.43.19

Description

Low-level, data-driven core of boto 3

Added to portage

2026-06-02

bpftrace - 0.26.1
Ebuild name:

dev-debug/bpftrace-0.26.1

Description

High-level tracing language for eBPF

Added to portage

2026-06-02

clang - 22.1.7
Ebuild name:

dev-python/clang-22.1.7

Description

Python bindings for llvm-core/clang

Added to portage

2026-06-02

docker-compose - 5.0.1-r2
Ebuild name:

app-containers/docker-compose-5.0.1-r2

Description

Multi-container orchestration for Docker

Added to portage

2026-06-02

docker-compose - 5.1.4-r1
Ebuild name:

app-containers/docker-compose-5.1.4-r1

Description

Multi-container orchestration for Docker

Added to portage

2026-06-02

faker - 40.20.0
Ebuild name:

dev-python/faker-40.20.0

Description

A Python package that generates fake data for you

Added to portage

2026-06-02

fakeredis - 2.36.0
Ebuild name:

dev-python/fakeredis-2.36.0

Description

Fake implementation of redis API for testing purposes

Added to portage

2026-06-02

grpcio - 1.81.0
Ebuild name:

dev-python/grpcio-1.81.0

Description

HTTP/2-based RPC framework

Added to portage

2026-06-02

grpcio-status - 1.81.0
Ebuild name:

dev-python/grpcio-status-1.81.0

Description

Reference package for GRPC Python status proto mapping

Added to portage

2026-06-02

hatchling - 1.30.1
Ebuild name:

dev-python/hatchling-1.30.1

Description

Modern, extensible Python build backend

Added to portage

2026-06-02

lit - 22.1.7
Ebuild name:

dev-python/lit-22.1.7

Description

A stand-alone install of the LLVM suite testing tool

Added to portage

2026-06-02

llvm - 22.1.7
Ebuild name:

dev-ml/llvm-22.1.7

Description

OCaml bindings for LLVM

Added to portage

2026-06-02

mariadb - 11.8.3-r5
Ebuild name:

dev-db/mariadb-11.8.3-r5

Description

An enhanced, drop-in replacement for MySQL

Added to portage

2026-06-02

mariadb - 11.8.5-r2
Ebuild name:

dev-db/mariadb-11.8.5-r2

Description

An enhanced, drop-in replacement for MySQL

Added to portage

2026-06-02

mariadb - 11.8.6
Ebuild name:

dev-db/mariadb-11.8.6

Description

An enhanced, drop-in replacement for MySQL

Added to portage

2026-06-02

mariadb - 12.0.2-r3
Ebuild name:

dev-db/mariadb-12.0.2-r3

Description

An enhanced, drop-in replacement for MySQL

Added to portage

2026-06-02

mgorny-dev-scripts - 74
Ebuild name:

app-portage/mgorny-dev-scripts-74

Description

Handy scripts for ebuild development and more

Added to portage

2026-06-02

mgorny-dev-scripts - 76
Ebuild name:

app-portage/mgorny-dev-scripts-76

Description

Handy scripts for ebuild development and more

Added to portage

2026-06-02

moccur-edit - 2.16
Ebuild name:

app-emacs/moccur-edit-2.16

Description

An improved interface to color-moccur for editing

Added to portage

2026-06-02

pypy - 3.11.7.3.20_p2-r1
Ebuild name:

dev-lang/pypy-3.11.7.3.20_p2-r1

Description

A fast, compliant alternative implementation of the Python () langu

Added to portage

2026-06-02

pypy - 3.11.7.3.22-r1
Ebuild name:

dev-lang/pypy-3.11.7.3.22-r1

Description

A fast, compliant alternative implementation of the Python () language

Added to portage

2026-06-02

pypy - 3.11.7.3.23-r1
Ebuild name:

dev-lang/pypy-3.11.7.3.23-r1

Description

A fast, compliant alternative implementation of the Python () language

Added to portage

2026-06-02

pyrate-limiter - 4.2.0
Ebuild name:

dev-python/pyrate-limiter-4.2.0

Description

Python Rate-Limiter using Leaky-Bucket Algorimth Family

Added to portage

2026-06-02

python - 0.3.13.13_p1-r1
Ebuild name:

dev-lang/python-0.3.13.13_p1-r1

Description

Freethreading (no-GIL) version of Python programming language

Added to portage

2026-06-02

python - 3.11.15-r1
Ebuild name:

dev-lang/python-3.11.15-r1

Description

An interpreted, interactive, object-oriented programming language

Added to portage

2026-06-02

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