Mac OS X Server 2 File Structure


Mac OS X Server 2 File Structure Layout

This is a reference for those who regularly poke around in the guts of OS X Server.

The file structure has changed quite a bit from the days of Server 1.x. Here's most of it, with a few notes here and there. Below is how the system looks after a completely clean install.

As always, this list is not meant to be exhaustive but to point the way to some things that you may be looking for and want to find in a hurry. Many files and lesser directories are left out.

  • directories in bold,
  • links in italics,
  • commentaries in grey,
  • {...} signifies a list of directories,
  • [blue names in brackets] means applications where you might not have expected one.


.Trashes
.vol
Applications
        AppleScript
                Example Scripts
        Dock Extras
        Utilities
Library
        Application Support
        Audio
                Plug-Ins
                        Components
                        Digidesign
                        VST
                Sounds
                        Alerts
                        Banks
        Caches
        ColorSync
                Profiles
                        Displays
                Scripts
        Desktop Pictures
        Documentation
                Administration
                        Services
                                sendmail
                Aladdin
                Commands
                        {dc, diffutils, grep, gzip, wget}
                Help
                        Apple Help Viewer
                        KotoeriHelp -> ...
                MacOSXServer
                        {English, French, German, Japanese}
                Services
        FTPServer
                Configuration
                FTPRoot
                        Public -> /Shared Items/Public
                        Users -> /Users
                Messages
        Fonts
        Image Capture
                Scripts
        Internet Plug-Ins
        Java
                Home -> /System/Library/Frameworks/JavaVM.framework/Home
        Logs
                AppleFileService
                DirectoryService
                PrintService
                WebServer -> /var/log/httpd             Well worth noting
                                                        new locale
                WindowsServices
        Modem Scripts
        Preferences
                DirectoryService
                LogViewer
        Printers
                PPD Plugins
                PPDs
        QuickTime
        QuickTimeStreaming
                AdminHtml {...}
                Logs
                Movies
                Playlists
        Receipts                        Receipts of what was installed
                                          where ends up in here and can be used
                                          to cleanly and easily de-install
        Screen Savers
        WebServer                       Where all your Apache files sit
                CGI-Executables         CGI / Perl scripts go here
                Documents               Default web page location
Network                                 Networked files and programs sit in here
        Applications
        Library
        Servers
        Users
Shared Items
        Public
System
        Library
                Assistants
                        SharedBundles
                Authenticators
                CFMSupport
                        BridgeLibraries
                        StubLibraries
                Caches
                Classic
                ColorPickers
                ColorSync
                        Profiles
                        Scripting
                Colors
                Components      KotoeriUIServer, WordRegister
                CoreServices    Assistant, Classic Startup, DocklingServer,
                                Finder, Help Viewer, SecurityAgent, Software Update,
                                StartATServer, WindowServer, loginwindow
                        SystemStarter
                DTDs
                Displays        DisplayServices
                        Overrides
                Extensions
                        AppleNDRV
                Filesystems
                        AppleShare
                Find
                Fonts
                Frameworks
                Image Capture
                        Devices          MassStorage, PTPCamera, Type1Camera
                Java
                        com
                                apple
                                        cocoa
                                                admin
                                                application
                                                assistant
                                                foundation
                                                        _private
                                                niaccess
                                                niinterface
                                                preferences
                                        misc
                                        net
                                                protocol
                                                        archiveresource
                                        security
                                        util
                Keyboards
                MonitorPanels
                OpenSSL
                        certs
                        lib
                        misc
                        private
                PHP
                        {Benchmark, Crypt, DB, Date, File, HTML
                         Mail, Net, PEAR, Payment, XML, extensions}
                Perl
                        {B, CGI, CPAN, Carp, Class, Devel, Exporter,
                         ExtUtils, File, Getopt, I18N, IO, IPC, Math,
                         Net, Pod, Search, Term, Test, Text, Tie, Time,
                         User, auto, darwin, pods, unicode, warnings}
                Preferences
                Printers
                        CVs
                                Modules
                        IOMs
                        Libraries
                                PrintJobMgr
                                        Contents
                                                MacOS
                                                Resources
                        PBMs
                        PDEs
                        PMs
                        PPDs
                                Contents
                                        Resources
                        Tools
                PrivateFrameworks
                QuickTime                 QuickTime Updater
                QuickTimeJava
                Rulebooks
                Screen Savers
                ScriptingAdditions        ColorSyncScripting, URL Access Scripting
                Security
                ServerAdmin
                Services
                Sounds
                Speech
                        Recognizers
                        Synthesizers
                        Voices
                StartupItems ((all have subdir Resources unless *))
                        Accounting
                        Apache
                        AppServices
                        AppleShare
                        AppleTalk
                        AuthServer
                        Cleanup
                        ConfigServer
                        CrashReporter
                        Cron
                        DirectoryServices
                        Disks
                        IPServices
                        NFS
                        Network
                        NetworkTime
                        Portmap
                        QuickTimeStreamingServer
                        SSH *
                        SecurityServer
                        Sendmail
                        SystemLog
                        SystemTuning
                        Watchdog *
                SystemConfiguration
                SystemResources
                        PrecompLists
                Tcl (...)
Users
        Shared
        (root account)
                .Trash
                Desktop
                Documents
                Library
                        Assistants
                        Audio
                                Plug-Ins
                                        Components
                                        Digidesign
                                        VST
                                Sounds
                                        Alerts
                                        Banks
                        Cache
                                Internet Cache
                        ColorPickers
                        ColorSync
                                Profiles
                        Favorites
                        FontCollections
                        Fonts
                        Internet Plug-Ins
                        Keyboards
                        Keychains
                        Preferences
                                Apple Help Prefs
                                        tmp
                                                Help
                                ByHost
                                Software Update
                                        Software Update Cache
                        Printers
                        Screen Savers
                        Sounds
                        Voices
                Movies
                Music
                Pictures
                Public
                        Drop Box
                Sites
                        images
Volumes
bin
cores -> private/cores
dev
etc -> private/etc
private
        Drivers
                ppc
        cores
        etc
                acgid
                httpd
                        ssl.crt
                        ssl.key
                        users
                mail
                streaming
        tmp (...)
        var
                at
                        jobs
                backups
                cron
                        tabs
                db
                        SystemConfiguration
                        dhcpclient
                                leases
                        netinfo
                                local.nibd
                log
                        acgid
                        httpd
                        webperfcache
                mail
                msgs
                named
                root
                        Library
                                Fonts
                                Preferences
                                        ByHost
                run                               pids for system things
                        davlocks
                        proxy
                rwho
                spool
                        Faxes
                        appkit
                        lpd
                        mqueue
                        output
                        printing
                        samba
                tmp (...)
                vm                                swap space
                yp
sbin
tmp -> private/tmp
usr
        bin
        include
                httpd
                        xml
                php {TSRM, Zend, ext, main, regex}
        lib
                java
                php
                        build
        libexec [MiniTerm]
                emacs (...)
                httpd
        local
                bin
                samba
                        bin
                        lib
                                codepages
                        private
                        swat
                        var
                sbin
                        StreamingServerModules
                        StreamingServerModules.disabled
                                QTSSFilePrivsModule
                                        Resources
                tomcat
                        bin
                        classes (...)
                        conf
                        doc (...)
                        lib (...)
                        logs
                        src
                        webapps (...)
        sbin
        share
                aclocal
                calendar
                dict                system dictionaries in here
                emacs (...)
                enscript
                gnats
                groff (...)
                httpd
                        font
                        tmac
                        icons
                info
                init
                        tcsh
                libtool
                        libltdl
                locale (...)
                man {man1, man2, ... man8}
                misc
                nvram
                sendmail
                        conf
                                {cf, domain, feature, hack, m4,
                                mailer, ostype, sh, siteconfig}
                skel
                tabset
                vi {catalog, perl, tcl}
                zoneinfo (...)
        standalone
                ppc
var -> private/var